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 的強大能力加速開發流程。