MCP堆栈编排器

MCP Stack Composer是一款智能编排工具,通过自然语言需求推荐并连接MCP服务器,适用于自动化工作流和多服务集成场景。

  • by Dalton-M
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Dalton-M/MCP-Navigator

使用说明

MCP堆栈生成器

🚀 一个智能编排器,根据自然语言要求推荐和连接MCP(模型上下文协议)服务器。

概述

MCP Stack Composer是一个黑客马拉松项目,展示了组合的力量:

  • 苯甲酸雌二醇 (云沙盒环境)
  • Docker MCP中心 (集装箱化MCP服务器)
  • Groq (用于能力分析和代码生成的快速LLM推理)
  • 多个MCP (GitHub、Brave Search、Stripe等)

特性

核心功能

  1. 自然语言→ 能力:用简单的英语描述你的代理人,通过Groq获得结构化的能力标签
  2. 智能MCP匹配:从Docker Hub自动将您的需求匹配到正确的MCP服务器
  3. 代码生成:准备好使用配置和代码片段
  4. 现场演示:真实的MCP调用以演示实际集成

🌟 突出功能(新增!)

  1. 多MCP工作流执行:真正的编排-多个MCP自动协同工作
  2. 预构建模板:5个适用于常见场景的现成工作流模板
  3. 成本估算:透明的成本明细和优化建议
  4. 实时执行:不仅仅是建议-实际的端到端自动化

快速开始

演示突出功能

# See all new features
python showcase_outstanding_features.py

# Run Multi-MCP workflow
python multi_mcp_workflow.py

先决条件

  • Python 3.9+
  • Docker桌面(可选,用于运行真正的MCP服务器)
  • Groq API密钥(免费层:https://console.groq.com/)
  • GitHub Token(可选,用于真实演示:https://github.com/settings/tokens)
  • 勇敢的API密钥(可选,用于网络搜索:https://brave.com/search/api/)

安装

# Clone the repository
git clone <your-repo-url>
cd MCP-Navigator

# Install dependencies
pip install -r requirements.txt

# Configure environment variables
cp .env.example .env
# Edit .env with your API keys

运行(模拟模式)

python app/main.py

示例输入:

I want an agent that reads GitHub issues, searches the web for similar solutions, and posts a daily summary.

项目结构

MCP-Navigator/
├── README.md
├── requirements.txt
├── .env.example
├── data/
│   └── mcp_catalog.json      # MCP catalog with capabilities
├── app/
│   ├── main.py               # CLI entry point
│   ├── config.py             # Configuration management
│   ├── planner.py            # Groq: requirements → capabilities
│   ├── matcher.py            # MCP matching logic
│   ├── snippet_generator.py  # Groq: generate config & code
│   └── mcp_client.py         # MCP invocation wrapper
└── tests/
    └── test_data/            # Mock response data

运作原理

  1. 用户输入:用自然语言描述你的代理人的要求
  2. 能力提取:Groq分析描述并输出标准化的能力标签
  3. MCP匹配:基于规则的算法将功能与MCP服务器相匹配
  4. 代码生成:Groq生成环境设置说明和代码片段
  5. 现场演示:执行一个真正的MCP调用来演示集成

需要API密钥

必要的

  • Groq API密钥:用于基于LLM的分析和代码生成
    • 注册地址:https://console.groq.com/
    • 免费等级:14400次请求/天

用于演示(至少1个)

  • GitHub代币:用于代码托管功能

    • 请访问:https://github.com/settings/tokens
    • 范围: repo, read:org
  • 勇敢搜索API:用于网络搜索功能

    • 注册地址:https://brave.com/search/api/
    • 免费等级:2000次查询/月

部署到E2B

  1. 在以下网址创建E2B帐户https://e2b.dev/
  2. 创建一个新的Python沙盒
  3. 在E2B UI中配置环境变量
  4. 克隆仓库并运行:
git clone <your-repo-url>
cd MCP-Navigator
pip install -r requirements.txt
python app/main.py

支持的MCP

  • GitHub(代码托管、问题管理)
  • 勇敢搜索(网络搜索)
  • 条纹(支付处理)
  • MongoDB(数据库操作)
  • 概念(生产力和笔记)
  • Elasticsearch(全文搜索)
  • 剧作家(浏览器自动化)
  • 困惑(网络研究)

许可证

麻省理工学院

黑客马拉松积分

专为[黑客马拉松名称]演示而设计:

  • E2B云沙盒
  • Docker MCP Hub集成
  • Groq LLM能力
  • 真正的MCP服务器编排