mcp-server-ledger: Ledger CLI MCP サーバー
概要
コマンドラインからアクセスできる強力な複式簿記システムであるLedger CLIと連携するためのモデルコンテキストプロトコルサーバーです。このサーバーにより、大規模言語モデルはLedger CLIツールを通じて財務データをクエリおよび分析できます。
この MCP サーバーは、標準化されたインターフェースを通じて Ledger CLI の機能を公開し、AI アシスタントが財務報告、予算分析、会計業務を簡単に支援できるようにします。
Related MCP server: Moneybird MCP Server
特徴
サーバーは、Ledger CLI コマンドにマップされる次のツールを提供します。
ledger_balance強力なフィルタリングオプションで口座残高を表示します
入力: クエリパターン、日付範囲、表示オプション
戻り値: フォーマットされた残高レポート
ledger_register詳細な履歴を含む取引記録を表示します
入力: クエリパターン、日付範囲、並べ替えオプション
戻り値: フォーマットされたレジスタレポート
ledger_accounts元帳ファイル内のすべてのアカウントを一覧表示します
入力: オプションのクエリパターン
戻り値: 一致するアカウントのリスト
ledger_payees取引のすべての受取人をリストします
入力: オプションのクエリパターン
戻り値: 一致する受取人のリスト
ledger_commodities使用されるすべての商品（通貨）をリストします
入力: オプションのクエリパターン
戻り値: 一致する商品のリスト
ledger_print取引を元帳形式で印刷します
入力: クエリパターン、日付範囲
戻り値: フォーマットされた元帳エントリ
ledger_stats元帳ファイルに関する統計情報を表示します
入力: オプションのクエリパターン
戻り値: 元帳の統計概要
ledger_budget予算分析を表示します
入力: クエリパターン、日付範囲、レポート期間
返品：予算レポート
ledger_raw_command生のLedger CLIコマンドを実行する
入力: コマンド引数を文字列のリストとして
戻り値: コマンド出力をテキストとして
前提条件
Ledger CLIがインストールされ、PATHで利用可能である必要があります。
財務データを含む有効な元帳ファイル
インストール
uvの使用（推奨）
このサーバーをインストールして実行する最も簡単な方法は、 uvを使用することです。
構成
サーバーはLedgerファイルへのパスを必要とします。これは以下の方法で提供できます。
LEDGER_FILE環境変数サーバー起動時のコマンドライン引数
Claude Desktopでの使用
これをclaude_desktop_config.jsonに追加します:
使用例
設定が完了すると、AI アシスタントに財務データに関する質問をすることができます。
「先月の支出を見せてください」
「すべてのアカウントの現在の残高はいくらですか？」
「Amazonとのすべての取引を一覧表示する」
「2023年に食料品にいくら使ったか？」
「第 1 四半期の予算実績を表示してください」
AI はサーバーを通じて適切な Ledger CLI コマンドを使用して情報を取得します。
デバッグ
より詳細なローカルテストについては、以下をご覧ください。
発達
このサーバーは、モデルコンテキストプロトコル Python SDKを使用して構築されています。MCP および MCP サーバーの開発方法の詳細については、公式ドキュメントをご覧ください。
このプロジェクトに貢献するには:
リポジトリをクローンする
開発依存関係をインストールする
変更を加える
MCPインスペクタを使用するか、Claude Desktopと統合してテストします。
セキュリティに関する考慮事項
このサーバーは、お客様の財務データに対してLedger CLIコマンドを実行します。コマンドインジェクションを防ぐための基本的な検証機能も備えていますが、以下の点にご注意ください。
信頼できるクライアントのみで使用してください
公開するファイルパスには注意してください
実行前にすべてのコマンドを確認する
ライセンス
このMCPサーバーはMITライセンスに基づいてライセンスされています。ライセンス条項に従って、自由に使用、改変、配布してください。