Mprokopov 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 Desktop の設定

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

MacOS の場合：~/Library/Application\ 支持/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 定数を変更することで、ベースパスを設定できます。