MCP Api Server Wrapper

🚀 MCP API 服务器模板

MCP API 服务器模板用于 API 集成。借助 AI 的力量，能轻松地将外部 API 封装成 MCP 服务器，极大提升开发效率。

🚀 快速开始

使用此模板，可以通过 AI 的帮助轻松地将外部 API 封装为 MCP 服务器。以下是具体步骤：

1. 项目克隆

git clone https://github.com/fnf-deepHeading/mcp-api-server-wrapper.git your-api-name-mcp  
cd your-api-name-mcp

2. 开发环境配置

# 同步依赖项  
uv sync

3. 向 AI 发起请求 按照如下格式进行请求：

# 目标: ~~ API 调用的 MCP 服务器实现
# 指导: `HOWTOMAKE.md` 文件中说明的指导，特别是 **"AI 助手的核心指导"** 部分（必填提示）
# API 信息:
# 1. 功能1: [链接]
# 2. 功能2: [链接]
# 工作方式: (可选提示)
一次性处理整个任务而不是逐个处理，并创建 TODO.md 和详细执行计划文件，然后逐一完成。
详细执行计划在没有询问进度的情况下进行一次处理。

示例：

# 目标: 集成三个 Naver API（博客搜索、新闻搜索、搜索量查询）以实现 MCP 服务器

# 指导: `HOWTOMAKE.md` 文件中说明的指导，特别是 **"AI 助手的核心指导"** 部分。

# API 信息:
# 1. Naver 博客搜索: https://developers.naver.com/docs/serviceapi/search/blog/blog.md#%EB%B8%94%EB%A1%9C%EA%B7%B8 
# 2. Naver 新闻搜索: https://developers.naver.com/docs/serviceapi/search/news/news.md#%EB%89%B4%EC%8A%A4 
# 3. Naver 搜索量查询: https://developers.naver.com/docs/serviceapi/datalab/search/search.md#%ED%86%B5%ED%95%A9-%EA%B2%80%EC%83%89%EC%96%B4-%ED%8A%B8%EB%A0%8C%EB%93%9C

4. 运行生成的代码 AI 将自动生成代码和配置文件，用户可以直接运行。

✨ 主要特性

• 利用 AI 实现自动化的 API 集成：借助 AI 自动解析 API 文档，减少手动编码时间。
• 使用命令行参数进行配置管理：支持通过命令行参数进行配置，方便快速调整设置。
• 支持 Docker：提供 Docker 镜像构建支持，用户可以轻松部署到生产环境。
• 提供详细的指南文档：为开发者提供全面的使用指导。

📚 详细文档

AI 集成

用户只需提供 API 文档链接，AI 将自动解析文档并生成相应的 MCP 服务器代码。

命令行配置

支持通过命令行参数进行配置，方便快速调整设置。

Docker 支持

提供 Docker 镜像构建支持，用户可以轻松部署到生产环境。

💻 使用示例

假设用户想集成一个天气 API：

基础用法

1. 用户向 AI 发送请求：

# 目标: 实现天气 API 的 MCP 服务器
# 指导: `HOWTOMAKE.md` 文件中说明的指导，特别是 **"AI 助手的核心指导"** 部分。
# API 信息:
# 1. 天气 API: https://openweathermap.org/api

2. AI 自动生成代码和配置文件，用户可以直接运行生成的服务器。

❓ 常见问题

• API 错误：如果生成的代码无法正确调用 API，请检查 API 文档是否正确。
• 依赖安装失败：确保网络连接正常，并且使用最新的 Python 版本。
• Docker 部署问题：确保 Docker 已正确安装，并且镜像构建命令无误。

🌟 优势

• 快速开发：利用 AI 自动化减少手动编码时间。
• 标准化结构：保持 MCP 服务器的统一架构，便于维护。
• 高效集成：支持多种 API 集成，提升开发效率。

通过这个模板，用户可以轻松地将各种外部 API 封装为功能完善的 MCP 服务器，同时利用 AI 的强大能力加速开发流程。