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クライアントは、公開デモAPIとして https://jsonplaceholder.typicode.com を使用しています。

実際のAPIでは、ApiClient の実装を置き換え、ビジネス/MCPのインターフェースを基本的に変更しないでください。

テストワークフローの実行