mcp-builder

MCP Server Builder

Model Context Protocol 서버 개발 및 구성

MCP 서버를 생성하고 Claude Code에 통합합니다.

---

사용법

신규 MCP 서버 생성

/mcp-builder "파일 시스템 접근" filesystem
/mcp-builder "데이터베이스 조회" database-query
/mcp-builder "API 통합" external-api

기존 MCP 서버 설정

/mcp-builder setup postgres
/mcp-builder configure playwright

---

MCP 서버 유형

1. Tools 서버

외부 도구 및 API 접근:

• 데이터베이스 쿼리
• 파일 시스템 조작
• 외부 API 호출
• 시스템 명령 실행

2. Resources 서버

정적 리소스 제공:

• 문서 검색
• 설정 파일 읽기
• 템플릿 제공

3. Prompts 서버

사전 정의된 프롬프트:

• 재사용 가능한 질의
• 템플릿 프롬프트

---

개발 워크플로우

1. 프로젝트 초기화

# Python MCP 서버
mkdir mcp-server-myproject
cd mcp-server-myproject
python -m venv venv
source venv/bin/activate
pip install mcp

2. 서버 구조 생성

mcp-server-myproject/
├── src/
│   ├── __init__.py
│   └── server.py           # MCP 서버 구현
├── pyproject.toml          # 의존성
└── README.md               # 사용법

3. Tools 정의

from mcp import Server, Tool

server = Server("myproject-server")

@server.tool()
async def my_tool(arg1: str, arg2: int) -> str:
    """도구 설명"""
    # 구현
    return result

4. 서버 실행

if __name__ == "__main__":
    server.run()

---

Claude Code 통합

1. MCP 설정 파일 수정

~/.claude/settings.json:

{
  "mcpServers": {
    "myproject": {
      "command": "python",
      "args": ["-m", "mcp_server_myproject"],
      "env": {
        "API_KEY": "your-key"
      }
    }
  }
}

2. 서버 시작

claude mcp list           # MCP 서버 목록 확인
claude mcp --help         # 가용 서브커맨드 확인(버전마다 달라질 수 있음)

---

템플릿

Python MCP Tools 서버

from mcp import Server
from typing import Any

server = Server("example-server")

@server.tool()
async def example_tool(
    param1: str,
    param2: int = 10
) -> dict[str, Any]:
    """
    Example tool description.

    Args:
        param1: First parameter
        param2: Second parameter (default: 10)

    Returns:
        Result dictionary
    """
    return {
        "result": f"Processed {param1} with {param2}",
        "status": "success"
    }

if __name__ == "__main__":
    server.run()