API 클라이언트 → 비즈니스 로직 → MCP 도구

일반 애플리케이션 코드와 MCP 도구 양쪽에서 API 클라이언트와 비즈니스 로직을 재사용하는 방법을 보여 주는 작은 Python 예제입니다.

구조

src/example/
├── api/
│   └── api_client.py
├── business/
│   └── service.py
├── mcp/
│   └── server.py
└── main.py

이 예제는 앱에서 노출하는 5개의 작업을 제공합니다.

1. get_user

2. list_users

3. create_user

4. update_user

5. delete_user

MCP 계층은 의도적으로 얇게 유지됩니다. MCP 입력을 검증한 후 비즈니스 서비스에 위임하고, 비즈니스 서비스는 HTTP 작업을 API 클라이언트에 위임합니다.

Related MCP server: JSONPlaceholder MCP Server

설치

python -m venv .venv
# Windows:
.venv\Scripts\activate
# Linux/macOS:
source .venv/bin/activate

pip install -r requirements.txt

MCP 서버 실행

python -m src.example.mcp.server

또는 MCP 클라이언트를 실행하도록 구성합니다.

python -m src.example.mcp.server

MCP 서버 사용

터미널을 통해

{"jsonrpc":"2.0","method":"tools/list","id":1}

또는 Claude

{
  "mcpServers": {
    "example-users": {
      "command": "python",
      "args": ["-m", "src.example.mcp.server"]
    }
  }
}

중요

이 예제는 자체 포함된 아키텍처 예제입니다. API 클라이언트는 https://jsonplaceholder.typicode.com을 공개 데모 API로 사용합니다.

실제 API의 경우 ApiClient 구현을 교체하고 비즈니스/MCP 인터페이스는 사실상 그대로 유지하세요.

테스트 워크플로 실행