AI导哈

分层MCP实现技术

一种将OpenAPI规范转换为模型上下文协议（MCP）服务器的分层实现技术，结合顺序思维工具进行智能问题解决。

  • by nafiul-earth
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 nafiul-earth/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实现技术。

相关 MCP