mcp-server-and-agent

Estado: en desarrollo. Andamiado, aún no implementado. Este README incluirá números generados cuando lleguen los primeros resultados.

Un servidor MCP escrito a mano a nivel de protocolo, más un agente LangGraph sobre él, con cuatro topologías ejecutadas sobre el mismo conjunto de tareas y sus modos de fallo medidos.

Este repositorio responde una pregunta:

¿Cuál es la tasa de fallo de cada topología de agente, y el supervisor realmente supera al agente único?

Todo lo que hay aquí sirve para responder esa pregunta. Las funcionalidades que no ayudan a responderla están fuera del alcance — deliberadamente.

¿Por qué existe?

Inicio rápido

uv sync --extra dev
uv run pytest -q
uv run python scripts/generate_results.py

Resultados

Aún no hay resultados.

Decisiones de diseño

Limitaciones

Conceptos cubiertos

• 2C servidor MCP escrito a mano y agente LangGraph (DO-8)

• 2C ReAct, plan-and-execute, reflexión

• 2C topologías y sus modos de fallo

• 2C diseño de herramientas: claridad del esquema, granularidad, errores como retroalimentación al modelo, idempotencia, compuertas de confirmación

• 2C MCP como protocolo: transportes, descubrimiento, recursos, prompts, muestreo, alcance OAuth

• 2C estado y memoria, checkpointing, ejecución durable

• …y 4 más (ver docs/inventory-coverage.md)

Licencia

MIT