MCP API服务器模板
用于API集成的MCP服务器模板。利用AI，您可以轻松地将外部API打包到MCP服务器。
特点
- 利用AI自动集成API
- 通过命令行参数管理设置
- Docker支持
- 提供详细的指南文档
使用AI创建MCP服务器
借助此模板，您可以在AI的帮助下轻松地将外部API打包到MCP服务器。
使用方法
- 项目克隆
git clone https://github.com/fnf-deepHeading/mcp-api-server-wrapper.git your-api-name-mcp
cd your-api-name-mcp- 设置开发环境
# 의존성 동기화
uv sync- 请以以下格式请求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- AI自动：
- 分析API文档 - 生成MCP服务器代码 - 配置配置文件 - 执行执行方法指南。
- （推荐收尾阶段）请向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"
]
}
}
}故障排除
常见问题
- API密钥错误
- .env 确保文件位于正确的位置 - 验证API密钥的格式是否正确
- 依赖性错误
- uv sync 使用命令重新安装依赖性 - 验证Python版本是否为3.10或更高版本
- Docker相关错误
- 检查Docker守护程序是否正在运行 - 确保映像构建正确
使用调试模式
- 无需直接编码即可集成API
- 只要有API文档，就可以快速实施
- 保持标准的MCP服务器结构
- 立即生成可执行代码
- 可直接在Claude等AI工具中使用
许可证
MIT许可证