API-Client → Geschäftslogik → MCP-Tools

Kleines Python-Beispiel, das zeigt, wie man einen API-Client und die Geschäftslogik sowohl aus normalem Anwendungscode als auch aus MCP-Tools wiederverwendet.

Struktur

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

Das Beispiel stellt 5 Operationen bereit:

1. get_user

2. list_users

3. create_user

4. update_user

5. delete_user

Die MCP-Ebene ist bewusst dünn gehalten: Sie validiert MCP-Eingaben und delegiert an den Geschäftsdienst. Der Geschäftsdienst delegiert die HTTP-Arbeit an den API-Client.

Related MCP server: JSONPlaceholder MCP Server

Installation

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

pip install -r requirements.txt

MCP-Server ausführen

python -m src.example.mcp.server

Oder konfigurieren Sie den MCP-Client so, dass er gestartet wird:

python -m src.example.mcp.server

MCP-Server verwenden

Über Terminal

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

Oder über Claude

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

Wichtig

Dies ist ein eigenständiges Architekturbeispiel. Der API-Client verwendet https://jsonplaceholder.typicode.com als öffentliche Demo-API.

Für eine echte API ersetzen Sie die Implementierung von ApiClient und behalten Sie die Geschäfts- und MCP-Schnittstellen im Wesentlichen unverändert.

Test-Workflow-Ausführung