Layered MCP

分层MCP实现

演示 分层MCP实现技术 用于将OpenAPI规范转换为模型上下文协议（MCP）服务器，并结合用于智能解决问题的顺序思维功能。

概述

该项目展示了如何使用分离发现、规划和执行的三层架构，根据OpenAPI规范构建企业级MCP服务器。它还集成了用于结构化问题解决的顺序思维工具。

特性

• 分层MCP架构：三层设计（Discovery→ 规划→ 执行）
• OpenAPI集成：使用自定义路由将OpenAPI规范转换为MCP工具
• 顺序思维：通过迭代思维动态解决问题
• 多种运输方式：HTTP、stdio和SSE支持
• 自定义路由配置：对API暴露的精细控制

快速开始

安装

您可以安装 mcp-composer 根据您的环境，有几种不同的方式。

1.使用 uv （建议用于此回购）

# Install all project dependencies from pyproject.toml / uv.lock
uv sync

# Activate the virtual environment (if not auto-activated)
source .venv/bin/activate

2.使用 pip 直接

python -m venv .venv
source .venv/bin/activate

pip install --upgrade pip
pip install "mcp-composer>=0.1.0.8.10"

3.全球工具安装（用于实验）

pip install "mcp-composer>=0.1.0.8.10"

有关安装选项和兼容性的更多详细信息，请参阅 mcp-composer PyPI页面.

配置

1. 创建 member_servers.json 使用OpenAPI配置：

{
  "id": "mcp-eventbrite",
  "type": "openapi",
  "open_api": {
    "endpoint": "https://www.eventbriteapi.com/v3",
    "spec_filepath": "./specs/eventbrite-openapi.json",
    "layered": true,
    "custom_routes": [
      {
        "methods": ["GET"],
        "pattern": ".*/users/.*",
        "mcp_type": "RESOURCE_TEMPLATE"
      },
      {
        "methods": ["GET"],
        "pattern": ".*/events/.*",
        "mcp_type": "TOOL"
      },
      {
        "methods": ["POST"],
        "pattern": ".*/",
        "mcp_type": "EXCLUDE"
      }
    ]
  },
  "auth_strategy": "bearer",
  "auth": {
    "token": "YOUR_TOKEN_HERE"
  }
}

跑步

# Set transport mode (http, stdio, or sse)
export MCP_MODE=sse

# Run the server
python main.py

文档

有关实施的详细信息，请参阅：

• 图层_MCP_示例.md -完整的指南涵盖：

- 分层MCP架构和设计原则 - 三层实施（发现、规划、执行） - 自定义路由配置 - 顺序思维工具的使用 - 最佳做法和实例

建筑

┌─────────────────────────────────────────────────────────┐
│                    MCP Client (Agent)                  │
└────────────────────┬────────────────────────────────────┘
                     │
┌────────────────────▼────────────────────────────────────┐
│              MCP Composer Gateway                        │
│  • Layer 1: Discovery (get_service_info)                │
│  • Layer 2: Planning (get_type_info)                    │
│  • Layer 3: Execution (make_tool_call)                  │
│  • Sequential Thinking Tool                             │
└────────────────────┬────────────────────────────────────┘
                     │
┌────────────────────▼────────────────────────────────────┐
│              OpenAPI-based Service                       │
└─────────────────────────────────────────────────────────┘

关键概念

分层MCP设计

分层方法将API操作组织为三个清晰的阶段：

1. 发现：了解可用的工具
2. 规划：解析模式并验证合约
3. 执行：使用已验证的参数执行API调用

这消除了歧义，减少了重试，并最大限度地减少了令牌的使用。

顺序思维

顺序思维工具使代理能够：

• 将复杂问题分解为可管理的步骤
• 随着理解的加深，修改之前的想法
• 通过分支探索替代推理路径
• 在多个交互中维护上下文

参考文献

• 针对MCP和工具调用的有效API策略 -IBM TechXchange 2025
• PyPI上的MCP编辑器
• 模型上下文协议
• 像Ogres一样构建MCP工具 - 带图层
• 没有MCP服务器组合，工具调用中断
• 分层MCP服务器架构
• MCP编辑器文档

许可证

本项目旨在演示分层MCP实现技术。