MCP API Server Wrapper - MCP Server

MCP API Server Template

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 License