元帳サービスMCPサーバー
Claude を通じて元帳ファイルにアクセスし、管理するための MCP サーバー。
コンポーネント
ツール
サーバーは、元帳管理用に次の 3 つのツールを実装します。
list-accounts : 元帳内のすべてのアカウントを一覧表示します
必須の引数として「year」を指定します
利用可能なすべてのアカウントのフォーマットされたリストを返します
account-balance : 特定のアカウントの残高を取得します
必須引数として「year」と「account」を指定します
指定されたアカウントの現在の残高を返します
account-register : アカウントの取引記録を表示します
必須引数として「year」と「account」を指定します
指定されたアカウントの詳細な取引履歴を返します
Related MCP server: GOAT MCP Server
インストール
前提条件
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 日
