Ledger MCP Server

🚀 账本サービス MCP サーバー

Claude を通じてレジャーファイルをアクセスおよび管理するための MCP サーバーです。

✨ 主な機能

ツール

このサーバーは、レジャー管理用の3つのツールを実装しています。

• list-accounts：レジャー内のすべてのアカウントをリストする

  • 「年」を必須パラメータとして受け取ります
  • 利用可能なすべてのアカウントのフォーマットされたリストを返します

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

  • 「年」と「アカウント」を必須パラメータとして受け取ります
  • 指定されたアカウントの現在の残高を返します

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

  • 「年」と「アカウント」を必須パラメータとして受け取ります
  • 指定されたアカウントの詳細な取引履歴を返します

📦 インストール

前提条件

• 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 デスクトップの設定ファイルに追加します。

• 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 定数を変更することで、ベースパスを設定できます。