ledger-mcp

Un pequeño servidor MCP que expone un libro mayor de partida doble como herramientas para agentes de IA. Construido como un ejercicio de dos días sobre diseño de servidores MCP, ergonomía de herramientas para agentes e iteración impulsada por evaluaciones.

Estado: Día 1 completado. Día 2 (marco de evaluación + hallazgos) en curso.

Qué hay aquí

• ledger.py — núcleo del libro mayor de partida doble, respaldado por SQLite. Los montos se almacenan como centavos enteros. Garantiza transacciones balanceadas e integridad de cuentas con nombre.

• server.py — servidor MCP que expone cuatro herramientas: create_account, record_transaction, get_balance, reconcile.

• test_ledger.py — suite de pytest para el núcleo del libro mayor.

• NOTES.md — registro continuo de decisiones de diseño y observaciones de ejecutar el servidor contra Claude Desktop.

Related MCP server: Agent Ledger

Ejecutar localmente

uv sync
uv run pytest -v          # run the ledger tests
uv run mcp dev server.py  # launch with the MCP Inspector

Para usar con Claude Desktop, agrégalo a claude_desktop_config.json:

{
  "mcpServers": {
    "ledger": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/ledger-mcp", "run", "mcp", "run", "server.py"]
    }
  }
}

Próximamente en el Día 2

• Marco de evaluación que mide dónde los agentes tienen éxito y fallan con estas herramientas

• Informe de hallazgos: nomenclatura vs. documentación, creación silenciosa de cuentas, herramienta como barrera de protección vs. herramienta como ejecutor.