AI导哈

HTTP API转MCP工具适配器

MCP Adapter是一个轻量级的HTTP API管理和适配系统，可将任何HTTP API转换为MCP（Model Context Protocol）工具，使AI助手能够直接调用这些API。

  • by cocofhu
  • Go
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 cocofhu/mcp-adapter

使用说明

MCP适配器

🚀 将任何HTTP API转换为MCP（模型上下文协议）工具，使人工智能助手能够调用您的API

一个轻量级的HTTP API管理和适配系统，允许您通过可视化界面配置API，自动生成MCP工具定义，并使Claude Desktop等人工智能助手能够直接调用您的HTTP端点。

✨ 主要特点

  • 🎯 零代码配置 -通过Web UI配置API，无需编写代码
  • 🔌 MCP协议支持 -自动将HTTP API转换为MCP工具
  • 🎨 自定义类型系统 -用于定义可重用复杂数据结构的类TypeScript系统
  • 📦 多应用管理 -支持管理多个独立的API应用程序
  • 🌐 现代用户界面 -响应式设计，操作直观

🚀 快速开始

使用Docker（推荐）

一键启动，无需依赖：

docker run -d \
  -p 8080:8080 \
  -v $(pwd)/data:/app/data \
  --name mcp-adapter \
  ccr.ccs.tencentyun.com/cocofhu/mcp-adapter

Windows PowerShell：

docker run -d -p 8080:8080 -v ${PWD}/data:/app/data --name mcp-adapter ccr.ccs.tencentyun.com/cocofhu/mcp-adapter

启动后，请访问： http://localhost:8080

从源头运行

# Clone the project
git clone https://github.com/yourusername/mcp-adapter.git
cd mcp-adapter

# Install dependencies
go mod download

# Start the service
go run main.go

服务将于以下时间开始 http://localhost:8080.

📖 使用工作流程

1.️⃣ 创建应用程序

在Web界面中创建一个新的应用程序，例如“Weather API”。

2.️⃣ 定义自定义类型（可选）

如果API使用复杂的数据结构，则可以首先定义自定义类型。

3.️⃣ 配置API端点

添加您的HTTP API端点配置：

  • 端点名称：GetWeather
  • 统一资源定位符: https://api.weather.com/current
  • 方法：获取
  • 参数:
    • city（字符串，查询，必填）
    • 单位（字符串、查询、可选）

4.️⃣ 连接到AI助手

配置Claude Desktop或其他MCP客户端以连接到：

http://localhost:8080/mcp/your-app-path

现在，您的AI助手可以调用配置的API了！

🎯 用例

  • 🤖 AI助手增强 -允许Claude和其他AI助手调用您的内部API
  • 🔗 API聚合 -统一管理和调用多个API
  • 📝 API 文档 -API定义的可视化管理和显示
  • 🧪 快速原型制作 -API集成的快速配置和测试

🔧 配置

环境变量

  • PORT -服务端口（默认值：8080）
  • DB_TYPE -数据库类型： sqlite 或 mysql （默认值：sqlite）
  • DB_PATH -SQLite数据库文件路径（默认：./data/mcp-adapter.db）
  • DB_DSN -MySQL连接字符串（例如： user:password@tcp(localhost:3306)/dbname?charset=utf8mb4&parseTime=True)

数据库支持

支持两者 SQLite 和 MySQL 数据库：

🗄️ SQLite（默认）

零配置，即用型，适用于中小型规模：

docker run -d \
  -p 8080:8080 \
  -v $(pwd)/data:/app/data \
  ccr.ccs.tencentyun.com/cocofhu/mcp-adapter

特性:

  • ✅ 零配置，随时可用
  • ✅ 重量轻，适合个人和小型团队
  • ✅ 数据持久性，重启后仍能存活
  • ✅ 完整的SQL功能支持

🐬 MySQL

适用于生产环境和大规模使用：

docker run -d \
  -p 8080:8080 \
  -e DB_TYPE=mysql \
  -e DB_DSN="user:password@tcp(mysql-host:3306)/mcp_adapter?charset=utf8mb4&parseTime=True" \
  ccr.ccs.tencentyun.com/cocofhu/mcp-adapter

特性:

  • ✅ 高性能，支持大规模并发
  • ✅ 适用于生产环境和集群部署
  • ✅ 支持主从复制和高可用性
  • ✅ 更好的数据安全性和备份能力

Docker数据持久化

SQLite模式：使用卷装载保存数据

docker run -d \
  -p 8080:8080 \
  -v /your/local/path:/app/data \
  ccr.ccs.tencentyun.com/cocofhu/mcp-adapter

MySQL模式：数据存储在MySQL服务器中，不需要本地目录挂载

🛠️ 技术栈

  • Go+Gin-后端服务
  • SQLite-数据存储
  • Vanilla JavaScript-前端接口
  • MCP协议-AI辅助协议

🤝 贡献

欢迎问题和拉取请求！

📝 许可证

MIT许可证

相关 MCP