mcp-server-and-agent

Estado: trabajo en progreso. Esqueleto, aún no implementado. Este README llevará números generados una vez que 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 aquí sirve para responder eso. Las características que no ayudan a responderlo están fuera de alcance — deliberadamente.

Por qué existe esto

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 más agente LangGraph (DO-8)

• 2C ReAct, planificar y ejecutar, reflexión

• 2C topologías y sus modos de fallo

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

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

• 2C estado y memoria, puntos de control, ejecución duradera

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

Licencia

MIT