元帳サービス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デスクトップの設定

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"
    ]
  }
}

発達

ローカルセットアップ

リポジトリをクローンする
仮想環境を作成してアクティブ化する
依存関係をインストールします:

ベースパスは、 server.pyのLEDGER_BASE_PATH定数を変更することによって設定できます。

ライセンス

GNU 一般公衆利用許諾書バージョン 3、2007 年 6 月 29 日

Ledger MCP Server