元帳サービスMCPサーバー

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

コンポーネント

ツール

サーバーは、元帳管理用に次の 3 つのツールを実装します。

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

  • 必須の引数として「year」を指定します

  • 利用可能なすべてのアカウントのフォーマットされたリストを返します

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

  • 必須引数として「year」と「account」を指定します

  • 指定されたアカウントの現在の残高を返します

• account-register : アカウントの取引記録を表示します

  • 必須引数として「year」と「account」を指定します

  • 指定されたアカウントの詳細な取引履歴を返します

Related MCP server: Monad MCP Tutorial

インストール

前提条件

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

発達

ローカルセットアップ

1. リポジトリをクローンする

2. 仮想環境を作成してアクティブ化する

3. 依存関係をインストールします:

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

ライセンス

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