ledger-mcp

一个小型 MCP 服务器，将复式记账账本作为工具暴露给 AI 代理。 作为一次为期两天的练习而构建，涉及 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 天计划

• 评估框架，衡量代理在这些工具上成功和失败的地方

• 发现报告：命名与文档、静默账户创建、工具作为护栏与工具作为执行者