MCP Universal Adapter

MCP通用适配器

⚠️ 项目状态：正在进行中 该项目尚处于早期开发阶段。核心功能正在实施中。欢迎投稿！

将任何API转换为功能齐全的MCP服务器只需几秒钟，而不是几天。

  

______________________________________________________________________

问题

手动构建MCP（模型上下文协议）服务器既缓慢又重复：

• 73.6k+颗星 awesome-mcp-servers 显示出巨大的需求
• 每个MCP服务器当前占用 2-5天 编码
• 有 15000+公共API，但只有约100个具有MCP适配器
• 开发人员一遍又一遍地编写相同的样板

解决方案

MCP通用适配器 根据任何API规范自动生成生产就绪MCP服务器：

# Transform Stripe API into MCP server
mcp-adapt --preset stripe --api-key sk_test_xxx

# Done! Now use in Claude/Cursor:
# "Create a Stripe customer for john@example.com and charge $99"

时间缩短： 5天→ 5 分钟⚡

______________________________________________________________________

🎯 视觉

制造 人工智能可访问的世界上每一个API 通过消除手动适配器写入瓶颈。

一个通用工具，为人工智能生态系统解锁数千个API。

______________________________________________________________________

✨ 功能（计划中）

核心能力

• ✅ OpenAPI 3.x支持 -解析任何OpenAPI规范
• ✅ GraphQL支持 -处理GraphQL模式
• ✅ REST发现 -从基本URL自动检测端点
• ✅ 多种语言 -生成Python或TypeScript服务器
• ✅ 认证 -支持API密钥、Bearer、OAuth2

预配置预设

• 🔄 条纹 -完成支付集成
• 🔄 GitHub -存储库和问题管理
• 🔄 开放人工智能 -AI模型组成
• 🔄 Slack -团队沟通自动化
• 🔄 SendGrid -电子邮件自动化

高级功能

• 🔄 HAR 导入 -从浏览器DevTools导入
• 🔄 邮差收藏 -将Postman转换为MCP
• 🔄 自动生成的测试 - Pytest/是测试套房
• 🔄 实时重新加载 -开发过程中的热重载
• 🔄 VS代码扩展 -IDE集成

传说：

• ✅ 进行中
• 🔄 计划的

______________________________________________________________________

🚀 快速开始

注： v0.1.0发布后，将提供安装说明。

安装（即将推出）

pip install mcp-universal-adapter

基本用法

# Generate from OpenAPI URL
mcp-adapt https://api.example.com/openapi.json \
  --output my-mcp-server

# Use preset for popular APIs
mcp-adapt --preset stripe --api-key sk_test_xxx

# Discover REST endpoints
mcp-adapt https://api.example.com \
  --discover \
  --output example-mcp

示例：条纹支付

mcp-adapt --preset stripe --api-key sk_test_YOUR_KEY

现在在克劳德/光标：

User: "Create a customer for john@example.com and charge $99 for Premium Plan"
AI: [Uses generated MCP server to]
    1. Create Stripe customer
    2. Create payment intent
    3. Process charge
    4. Return confirmation

______________________________________________________________________

🏗️ 建筑

API Input (OpenAPI/GraphQL/REST)
         ↓
    Parser Layer
         ↓
  Schema Normalizer
         ↓
   MCP Generator
         ↓
  Code Templates (Jinja2)
         ↓
MCP Server Output (Python/TS)
         ↓
  Validation & Testing

组件

1. 解析器 -从各种格式中提取API结构
2. 标准化器 -统一的API表示
3. 发电机 -创建MCP服务器代码
4. 模板 -特定语言的代码模板
5. 验证器 -测试生成的服务器

______________________________________________________________________

📚 文档

正在编写文件。请尽快回来查看！

• 快速入门指南 -即将推出
• API 参考 -即将推出
• 预设指南 -即将推出
• 烹饪书 -示例食谱

______________________________________________________________________

🛣️ 路线图

冲刺1（第1-5天）：基础

• \[\]项目设置和存储库结构
• \[\]OpenAPI 3.x解析器
• \[\]Python MCP生成器
• \[\]CLI界面（打字机）
• \[\]首次使用Stripe进行工作演示

冲刺2（第6-10天）：波兰语和预设

• \[\]错误处理和验证
• \[\]5个API预设（Stripe、GitHub、OpenAI、Slack、SendGrid）
• \[\]综合文件
• \[\]v0.1.0版本发布

Sprint 3（第11-14天）：高级功能

• \[\]GraphQL支持
• \[\]REST端点发现
• \[\]HAR文件导入
• \[\]VS代码扩展名

未来

• TypeScript生成器
• 网络游乐场（Streamlit）
• GitHub行动
• Docker镜像
• 社区预设市场

______________________________________________________________________

💡 用例

1.付款（条纹）

mcp-adapt --preset stripe
# Enable: "Process $99 payment for customer@email.com"

2.GitHub自动化

mcp-adapt --preset github --token ghp_xxx
# Enable: "Create urgent bug issue in myapp repo"

3.团队沟通（Slack）

mcp-adapt --preset slack --workspace myteam
# Enable: "Post 'Deployment done' to #engineering"

4.自定义内部API

mcp-adapt https://api.mycompany.com/swagger.json
# Enable your company's API for AI agents!

______________________________________________________________________

🤝 贡献

我们正处于早期开发阶段，希望您的帮助！

需要优先捐款：

1. API预设 -添加对流行API的支持
2. TypeScript生成器 -实施TS模板
3. GraphQL解析器 -完全支持GraphQL
4. 文档 -编写指南和示例
5. 测试 -提高测试覆盖率

如何做出贡献：

# 1. Fork the repository
# 2. Clone your fork
git clone https://github.com/YOUR_USERNAME/mcp-universal-adapter.git
cd mcp-universal-adapter

# 3. Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# 4. Install dependencies
pip install -e ".[dev]"

# 5. Create feature branch
git checkout -b feature/amazing-feature

# 6. Make changes and test
pytest tests/

# 7. Commit and push
git commit -m "feat: add amazing feature"
git push origin feature/amazing-feature

# 8. Open Pull Request

看 贡献.md 详细指南。

______________________________________________________________________

🎯 成功指标

发布目标（前30天）：

• 5000多个GitHub之星
• 100多台生成的MCP服务器
• 20+API预设
• 列在 awesome-mcp-servers

______________________________________________________________________

📜 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

______________________________________________________________________

🌟 明星历史


______________________________________________________________________

📧 联系

巴托斯·加卡 -人工智能与自动化策略师

• 电子邮件：gaca.bartosz@gmail.com
• 网站： bartoszgaca.pl
• github： @加卡巴托什

______________________________________________________________________

🙏 致谢

• 模型上下文协议 -使这成为可能的协议
• Anthropic -用于Claude和MCP规范
• 很棒的mcp服务器 -灵感与社区

______________________________________________________________________

内置❤️ 实现AI-API一体化的民主化

*停止写入适配器。开始建造。*