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 
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 
cd MCP-Navigator
pip install -r requirements.txt
python app/main.py

支持的MCP

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

许可证

麻省理工学院

黑客马拉松积分

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

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