ledger-mcp

AIエージェント向けに複式簿記台帳をツールとして公開する小さなMCPサーバー。 MCPサーバー設計、エージェントツールの使いやすさ、評価駆動型の反復開発をテーマにした2日間の演習として構築。

ステータス: 1日目完了。2日目（評価ハーネス＋所見）は進行中。

内容

• ledger.py — SQLiteをバックエンドにした複式簿記台帳のコア。金額は整数セントで保存。取引のバランスと名前付きアカウントの整合性を強制。

• server.py — 4つのツール（create_account、record_transaction、get_balance、reconcile）を公開するMCPサーバー。

• 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日目の予定

• これらのツールでエージェントが成功する箇所と失敗する箇所を測定する評価ハーネス

• 所見のまとめ：命名とドキュメント、暗黙のアカウント作成、ガードレールとしてのツールと実行者としてのツール