MCP API Server Template

MCP API 服务器模板

这是一个用于 API 集成的 MCP 服务器模板。借助 AI，您可以轻松地将外部 API 封装为 MCP 服务器。

特点

• 借助 AI 自动集成 API
• 通过命令行参数管理配置
• 支持 Docker
• 提供详细的指南文档

使用 AI 创建 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)과 세부 실행계획 파일을 만들고 하나씩 체크하며 진행하세요.
세부 실행계획은 진행여부 묻지 말고 한번에 진행하세요.

示例：

# 목표: 네이버 API 3개(블로그 검색, 뉴스 검색, 검색량 조회)를 호출할 수 있는 MCP 서버 구현

# 지침: `HOWTOMAKE.md` 파일에 명시된 지침, 특히 **"AI 어시스턴트를 위한 핵심 지침"** 섹션을 반드시 따라주세요.

# API 정보:
# 1. 네이버 블로그 검색: https://developers.naver.com/docs/serviceapi/search/blog/blog.md#%EB%B8%94%EB%A1%9C%EA%B7%B8 
# 2. 네이버 뉴스 검색: https://developers.naver.com/docs/serviceapi/search/news/news.md#%EB%89%B4%EC%8A%A4 
# 3. 네이버 검색량 조회: 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 会自动：

   • 分析 API 文档
   • 生成 MCP 服务器代码
   • 配置设置文件
   • 指导您如何运行。

5. （推荐的收尾步骤）为检查代码，请按以下方式向 AI 提出请求：

코드를 점검해주세요.  
다음 기준에 따라 피드백을 주고 수정해주세요:
1. 문법 오류나 실행 시 오류 발생 가능성
2. 비효율적인 로직이나 중복 코드
3. 성능 개선이 가능한 부분
4. 가독성을 높일 수 있는 개선사항
5. 일반적인 코드 컨벤션 위반 여부 (예: PEP8, Google Style 등)

在 Claude 中使用

要在 Claude 中使用 MCP 服务器，请按以下方式进行设置：

设置示例：

{
  "mcpServers": {
    "[서버 이름]": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/project",
        "run",
        "server.py",
        "--API_KEY",
        "your_api_key"
      ]
    }
  }
}

故障排除

常见问题

1. API 密钥错误

   • 确认 .env 文件位于正确的位置
   • 确认 API 密钥的格式正确

2. 依赖项错误

   • 使用 uv sync 命令重新安装依赖项
   • 确认 Python 版本为 3.10 或更高

3. Docker 相关错误

   • 确认 Docker 守护进程正在运行
   • 确认镜像已正确构建

使用调试模式

• 无需直接编写代码即可集成 API
• 只需 API 文档即可快速实现
• 保持标准化的 MCP 服务器结构
• 生成可立即运行的代码
• 可直接在 Claude 等 AI 工具中使用

许可证

MIT 许可证