Cliente de API → Lógica de negocio → Herramientas MCP

Pequeño ejemplo en Python que muestra cómo reutilizar un cliente de API y la lógica de negocio tanto desde el código normal de la aplicación como desde las herramientas MCP.

Estructura

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

El ejemplo expone 5 operaciones:

1. get_user

2. list_users

3. create_user

4. update_user

5. delete_user

La capa MCP es deliberadamente delgada: valida las entradas de MCP y delega en el servicio de negocio. El servicio de negocio delega el trabajo HTTP al cliente de API.

Related MCP server: JSONPlaceholder MCP Server

Instalación

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

pip install -r requirements.txt

Ejecutar el servidor MCP

python -m src.example.mcp.server

O configura el cliente MCP para iniciarlo:

python -m src.example.mcp.server

Usar el servidor MCP

Mediante terminal

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

O Claude

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

Importante

Este es un ejemplo arquitectónico autocontenido. El cliente de API utiliza https://jsonplaceholder.typicode.com como API de demostración pública.

Para una API real, reemplaza la implementación de ApiClient y mantén las interfaces de negocio/MCP esencialmente sin cambios.

Probar la ejecución del flujo de trabajo