API-клиент → Бизнес-логика → MCP-инструменты

Небольшой пример на Python, показывающий, как переиспользовать API-клиент и бизнес-логику как из обычного кода приложения, так и из MCP-инструментов.

Структура

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-интерфейсы практически без изменений.

Выполнение тестового рабочего процесса