Docker Docker Image

MCP智能网关镜像文档

概述

MCP智能网关是AI工具目录的核心组件，负责AI工具的接入、管理与协同调度，提供统一的接口层与流量控制能力，简化AI工具的集成与使用流程。

特性

• 工具接入管理：支持多类型AI工具的标准化接入，提供注册、注销与状态监控功能
• 流量调度：动态分发工具请求流量，优化资源利用率与响应速度
• 协议适配：兼容REST、gRPC等多种通信协议，实现跨工具的协议转换
• 安全控制：集成身份认证与权限校验机制，保障工具调用的安全性
• 监控与日志：提供访问日志与性能指标采集，支持问题排查与系统优化

使用场景

• AI工具集成平台：作为统一入口整合分散的AI工具，提供一致的调用体验
• 多工具协同系统：协调不同AI工具的任务分配与结果聚合，支撑复杂业务流程
• 工具服务化部署：将AI工具封装为标准化服务，通过网关对外提供稳定访问接口

Docker部署示例

bash
# 基础运行命令
docker run -d \
  --name mcp-smart-gateway \
  -p 8080:8080 \
  -v /host/config:/app/config \
  -e LOG_LEVEL=info \
  -e REGISTRY_ADDR=http://ai-tool-registry:8500 \
  docker.xuanyuan.run/mcp-smart-gateway:latest

说明：

• -p 8080:8080：映射网关服务端口
• -v /host/config:/app/config：挂载主机配置目录，包含工具注册信息与路由规则
• LOG_LEVEL：日志级别（debug/info/warn/error）
• REGISTRY_ADDR：AI工具目录注册中心地址

注意事项

• 配置文件需使用YAML格式，包含tools（工具列表）、routes（路由规则）与security（安全配置）节点
• 需确保与AI工具注册中心网络连通，推荐通过Docker网络实现容器间通信
• 生产环境建议配置健康检查与自动重启策略，保障服务可用性