ledger-mcp

Небольшой MCP-сервер, предоставляющий двойную бухгалтерию в виде инструментов для ИИ-агентов. Создан как двухдневное упражнение по проектированию MCP-серверов, эргономике инструментов для агентов и итеративной разработке на основе оценок.

Статус: День 1 завершён. День 2 (харнесс для оценки + выводы) в процессе.

Что здесь есть

• ledger.py — ядро двойной бухгалтерии на базе SQLite. Суммы хранятся в целых центах. Обеспечивает сбалансированность транзакций и целостность именованных счетов.

• server.py — MCP-сервер, предоставляющий четыре инструмента: create_account, record_transaction, get_balance, reconcile.

• test_ledger.py — набор pytest для ядра бухгалтерии.

• NOTES.md — текущий журнал проектных решений и наблюдений от запуска сервера с Claude Desktop.

Related MCP server: Agent Ledger

Запуск локально

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

Чтобы использовать с Claude Desktop, добавьте в claude_desktop_config.json:

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

Что будет на День 2

• Харнесс для оценки, измеряющий, где агенты преуспевают и ломаются при работе с этими инструментами

• Отчёт о выводах: именование против документации, молчаливое создание счетов, инструмент как защитный барьер против инструмента как исполнителя.