buru2020/one-mcp

MCP服务集中式代理镜像

镜像概述

该镜像提供Model Context Protocol (MCP)服务的集中式代理功能，作为MCP服务的统一入口，负责接收、路由和转发MCP协议请求，简化多服务环境下的通信管理，提升系统可维护性与扩展性。

核心功能与特性

• 集中式请求处理：统一接收所有MCP协议请求，实现请求的集中管理与转发
• 服务路由：支持基于规则的请求路由，可根据服务标识、版本等维度分发请求
• 协议适配：兼容MCP协议的不同版本，确保新旧服务间的通信兼容性
• 负载均衡：内置多种负载均衡策略（轮询、权重、最小连接数），优化后端服务资源利用
• 监控与日志：提供请求 metrics 采集和详细日志记录，支持问题排查与性能分析

使用场景

• 多MCP服务实例部署环境，需统一请求入口
• 微服务架构中MCP服务的流量管理与分发
• 需要对MCP服务通信进行监控、限流或安全控制的场景
• 跨环境MCP服务集成（如开发、测试、生产环境隔离部署）

使用方法

基本部署（Docker Run）

bash
docker run -d -p 8080:8080 --name mcp-proxy \
  -e MCP_BACKEND_SERVICES="http://mcp-service-1:8081,http://mcp-service-2:8082" \
  -e LOG_LEVEL="info" \
  -e LOAD_BALANCE_STRATEGY="round_robin" \
  docker.xuanyuan.run/your-registry/mcp-proxy:latest

环境变量配置

Docker Compose配置示例

yaml
version: '3.8'
services:
  mcp-proxy:
    image: docker.xuanyuan.run/your-registry/mcp-proxy:latest
    container_name: mcp-proxy
    ports:
      - "8080:8080"
    environment:
      - MCP_BACKEND_SERVICES=http://mcp-service-a:8081,http://mcp-service-b:8082
      - LOG_LEVEL=debug
      - LOAD_BALANCE_STRATEGY=weighted
      - REQUEST_TIMEOUT=45
    restart: unless-stopped
    networks:
      - mcp-network

networks:
  mcp-network:
    driver: bridge

验证部署

部署完成后，可通过以下命令验证代理服务是否正常运行：

bash
curl http://localhost:8080/health

正常响应应为：{"status":"healthy","backend_services":2,"active_connections":0}