mcp-agent-kit

Un servidor y entorno de herramientas para el Model Context Protocol (MCP) basado exclusivamente en la biblioteca estándar, para Claude Desktop, Cursor y flotas de agentes autónomos.

Inicio rápido • Arquitectura • Configuración de Claude Desktop • Comparación • Rigor de ingeniería

Arquitectura

Related MCP server: MCP-123

¿Por qué mcp-agent-kit?

Los SDK oficiales de MCP incorporan decenas de dependencias pesadas de terceros (pydantic, anyio, httpx, starlette), lo que crea superficies de ataque innecesarias en la cadena de suministro y fricción de instalación en entornos empresariales.

mcp-agent-kit proporciona una implementación completa y lista para producción del Model Context Protocol utilizando 100% la biblioteca estándar de Python:

• 🚀 Cero dependencias en tiempo de ejecución: Python puro (json, sys, inspect, dataclasses).

• 🔒 Listo para entornos empresariales: auditabilidad inmediata sin exposición a vulnerabilidades de paquetes.

• ⚡ Ultraligero: tiempo de arranque inferior a un milisegundo, ideal para herramientas CLI, entornos serverless e integraciones de agentes embebidos desplegados en el cliente.

• 🛠️ Generación automática de esquemas: infiere definiciones de JSON Schema directamente de los type hints y docstrings nativos de Python.

mcp-agent-kit vs SDK oficial de MCP

Inicio rápido

1. Crea un servidor MCP en 20 líneas

from mcp_agent_kit import MCPServer

app = MCPServer(name="my-agent-tools", version="1.0.0")

@app.tool(description="Calculate tax and total invoice amounts")
def calculate_invoice(subtotal: float, tax_rate: float = 0.07) -> dict:
    tax = round(subtotal * tax_rate, 2)
    return {"subtotal": subtotal, "tax": tax, "total": round(subtotal + tax, 2)}

if __name__ == "__main__":
    app.run_stdio()

Integración con Claude Desktop

Añade tu servidor directamente a claude_desktop_config.json:

{
  "mcpServers": {
    "my-tools": {
      "command": "python",
      "args": ["-m", "examples.simple_server"]
    }
  }
}

¡Reinicia Claude Desktop y tus herramientas personalizadas aparecerán inmediatamente en el cinturón de herramientas de Claude! 🔨

Características

• Handshake MCP completo: initialize, notifications/initialized, ping.

• Descubrimiento dinámico de herramientas: tools/list con generación automática de esquemas JSON.

• Límites de error robustos: tools/call aísla las excepciones de tiempo de ejecución de las herramientas y devuelve mensajes de error estructurados al LLM sin bloquear el proceso stdio.

• Cero dependencias: funciona sin configuración adicional en Python 3.10+.

Rigor de ingeniería y verificación

• Pruebas: suite de pruebas pytest con un 100% de aprobación que cubre inicialización, descubrimiento de herramientas, validación de argumentos y manejo de excepciones.

• Dependencias: 0 dependencias en tiempo de ejecución.

• Autor: Reuben Bowlby — LinkedIn | Currículum

Escala empresarial

mcp-agent-kit forma parte del ecosistema de desarrollo HUMMBL. Para gobernanza multiagente de nivel empresarial (interruptores de apagado de 4 etapas, tokens de delegación firmados con HMAC y buses de auditoría criptográficos), visita github.com/hummbl-io.