ledger-service MCP server

ledger-service MCP サーバー

Claude を通じて台帳ファイルにアクセスし、管理するための MCP サーバーです。

コンポーネント

ツール

このサーバーは、台帳を管理するための 3 つのツールを実装しています。

• list-accounts：台帳内のすべてのアカウントを一覧表示します

  • 必須の引数として「year」を受け取ります
  • 利用可能なすべてのアカウントを整形して返します

• account-balance：特定のアカウントの残高を取得します

  • 必須の引数として「year」と「account」を受け取ります
  • 指定したアカウントの現在の残高を返します

• account-register：アカウントの取引明細を表示します

  • 必須の引数として「year」と「account」を受け取ります
  • 指定したアカウントの詳細な取引履歴を返します

インストール

前提条件

• Python 3.13 以降
• uv パッケージマネージャー
• Node.js と npm（デバッグ用）

PyPI からインストール

uv pip install ledger-service

デバッグ

インスペクターを使ってサーバーをデバッグします。

npx @modelcontextprotocol/inspector \
  uv \
  --directory /path/to/ledger-service \
  run \
  ledger-service

Claude Desktop の設定

サーバーの設定を Claude Desktop の設定ファイルに追加します。

MacOS の場合：~/Library/Application\ Support/Claude/claude_desktop_config.json Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

"mcpServers": {
  "ledger-service": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/ledger-service",
      "run",
      "ledger-service"
    ]
  }
}

"mcpServers": {
  "ledger-service": {
    "command": "uvx",
    "args": [
      "ledger-service"
    ]
  }
}

開発

ローカル環境のセットアップ

1. リポジトリをクローンします
2. 仮想環境を作成して有効化します
3. 依存関係をインストールします。

ベースパスは、server.py の LEDGER_BASE_PATH 定数を変更して設定できます。

ライセンス

GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007