模型上下文协议平台

用于管理和监控多个MCP服务器请求的路由和分发的平台。

  • by kogunlowo123
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 kogunlowo123/claude-mcp-platform

使用说明

克劳德mcp平台

MCP(模型上下文协议)平台编排器,用于管理、路由和监控跨多个MCP服务器的请求。

建筑

flowchart TD
    A[Client Request] --> B[MCP Platform]
    B --> C[Request Router]
    C --> D{Route Resolution}
    D -->|Direct Match| E[Target Server]
    D -->|Pattern Match| F[Rule-Based Routing]
    D -->|Fallback| G[Round-Robin Selection]
    F --> E
    G --> E
    B --> H[Server Registry]
    H --> I[Register / Deregister]
    H --> J[Capability Discovery]
    B --> K[Health Checker]
    K --> L{Health Status}
    L -->|Healthy| M[Active Pool]
    L -->|Degraded| N[Warning State]
    L -->|Unhealthy| O[Removed from Routing]
    B --> P[Metrics Endpoint]
    P --> Q[Request Stats]
    P --> R[Latency Tracking]
    P --> S[Server Status]

    style A fill:#4A90D9,stroke:#2E6BA6,color:#FFFFFF
    style B fill:#2ECC71,stroke:#27AE60,color:#FFFFFF
    style C fill:#F39C12,stroke:#E67E22,color:#FFFFFF
    style D fill:#9B59B6,stroke:#8E44AD,color:#FFFFFF
    style E fill:#1ABC9C,stroke:#16A085,color:#FFFFFF
    style F fill:#F39C12,stroke:#E67E22,color:#FFFFFF
    style G fill:#F39C12,stroke:#E67E22,color:#FFFFFF
    style H fill:#3498DB,stroke:#2980B9,color:#FFFFFF
    style I fill:#3498DB,stroke:#2980B9,color:#FFFFFF
    style J fill:#3498DB,stroke:#2980B9,color:#FFFFFF
    style K fill:#E74C3C,stroke:#C0392B,color:#FFFFFF
    style L fill:#9B59B6,stroke:#8E44AD,color:#FFFFFF
    style M fill:#2ECC71,stroke:#27AE60,color:#FFFFFF
    style N fill:#F1C40F,stroke:#F39C12,color:#333333
    style O fill:#E74C3C,stroke:#C0392B,color:#FFFFFF
    style P fill:#1ABC9C,stroke:#16A085,color:#FFFFFF
    style Q fill:#1ABC9C,stroke:#16A085,color:#FFFFFF
    style R fill:#1ABC9C,stroke:#16A085,color:#FFFFFF
    style S fill:#1ABC9C,stroke:#16A085,color:#FFFFFF

特性

  • 服务器注册表 -通过基于功能的查找注册和发现MCP服务器
  • 请求路由 -基于模式的路由,具有优先级规则和回退支持
  • 健康监测 -定期健康检查,自动状态管理
  • 指标收集 -跟踪请求计数、延迟和服务器可用性
  • Docker支持 -生产就绪的Dockerfile和docker组合配置

快速开始

使用Bun

bun install
bun run dev

使用Docker(生产)

docker-compose up -d

使用Docker(开发)

# Create your local env file from the template
cp .env.example .env.dev

# Start with hot-reload
docker-compose -f docker-compose.dev.yml up --build

源代码是批量挂载的,因此更改为 src/ 通过以下方式自动提取 bun run --watch。命名卷用于 node_modules 以避免主机覆盖。

API终点

方法 路径 描述
GET /health 平台运行状况
GET /指标 平台指标
GET /servers 列出已注册的服务器
POST /servers 注册新服务器
POST /route 将请求路由到服务器

配置

环境变量 默认值 描述
MCP_PORT 3000 服务器端口
MCP_HOST 0.0.0.0 服务器主机
MCP_LOGLEVEL 信息 日志级别
MCP_HEALTH_INTERVAL 30000 健康检查间隔(ms)
MCP_REQUEST_TIMEOUT 10000 请求超时(毫秒)
MCP_MAX_RETRIES 3 最大重试次数

许可证

MIT许可证-请参阅 许可证 了解详情。