mcp-server-ledger: Ledger CLI MCP サーバー

概要

コマンドラインからアクセスできる強力な複式簿記システムであるLedger CLIと連携するためのモデルコンテキストプロトコルサーバーです。このサーバーにより、大規模言語モデルはLedger CLIツールを通じて財務データをクエリおよび分析できます。

この MCP サーバーは、標準化されたインターフェースを通じて Ledger CLI の機能を公開し、AI アシスタントが財務報告、予算分析、会計業務を簡単に支援できるようにします。

特徴

サーバーは、Ledger CLI コマンドにマップされる次のツールを提供します。

1. ledger_balance

   • 強力なフィルタリングオプションで口座残高を表示します

   • 入力: クエリパターン、日付範囲、表示オプション

   • 戻り値: フォーマットされた残高レポート

2. ledger_register

   • 詳細な履歴を含む取引記録を表示します

   • 入力: クエリパターン、日付範囲、並べ替えオプション

   • 戻り値: フォーマットされたレジスタレポート

3. ledger_accounts

   • 元帳ファイル内のすべてのアカウントを一覧表示します

   • 入力: オプションのクエリパターン

   • 戻り値: 一致するアカウントのリスト

4. ledger_payees

   • 取引のすべての受取人をリストします

   • 入力: オプションのクエリパターン

   • 戻り値: 一致する受取人のリスト

5. ledger_commodities

   • 使用されるすべての商品（通貨）をリストします

   • 入力: オプションのクエリパターン

   • 戻り値: 一致する商品のリスト

6. ledger_print

   • 取引を元帳形式で印刷します

   • 入力: クエリパターン、日付範囲

   • 戻り値: フォーマットされた元帳エントリ

7. ledger_stats

   • 元帳ファイルに関する統計情報を表示します

   • 入力: オプションのクエリパターン

   • 戻り値: 元帳の統計概要

8. ledger_budget

   • 予算分析を表示します

   • 入力: クエリパターン、日付範囲、レポート期間

   • 返品：予算レポート

9. 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 サーバーの開発方法の詳細については、公式ドキュメントをご覧ください。

このプロジェクトに貢献するには:

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

2. 開発依存関係をインストールする

3. 変更を加える

4. MCPインスペクタを使用するか、Claude Desktopと統合してテストします。

セキュリティに関する考慮事項

このサーバーは、お客様の財務データに対してLedger CLIコマンドを実行します。コマンドインジェクションを防ぐための基本的な検証機能も備えていますが、以下の点にご注意ください。

• 信頼できるクライアントのみで使用してください

• 公開するファイルパスには注意してください

• 実行前にすべてのコマンドを確認する

ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。ライセンス条項に従って、自由に使用、改変、配布してください。