Skip to main content
Glama
deenesjakoruzh

Ledger CLI MCP Server

by minhyeoky
GitHub
Python
15
  • Apple
  • Linux
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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を使用することです。

uv sync

構成

サーバーはLedgerファイルへのパスを必要とします。これは以下の方法で提供できます。

  • LEDGER_FILE環境変数
  • サーバー起動時のコマンドライン引数

Claude Desktopでの使用

これをclaude_desktop_config.jsonに追加します:

"mcpServers": { "ledger": { "command": "uv", "args": [ "run", "--env-file", "/path/to/your/.env", // Optional: to set LEDGER_FILE "--with", "mcp[cli]", "mcp", "run", "<repo_path>/main.py" // Path to the main.py file in this repository ] } }

使用例

設定が完了すると、AI アシスタントに財務データに関する質問をすることができます。

  • 「先月の支出を見せてください」
  • 「すべてのアカウントの現在の残高はいくらですか？」
  • 「Amazonとのすべての取引を一覧表示する」
  • 「2023年に食料品にいくら使ったか？」
  • 「第 1 四半期の予算実績を表示してください」

AI はサーバーを通じて適切な Ledger CLI コマンドを使用して情報を取得します。

デバッグ

より詳細なローカルテストについては、以下をご覧ください。

mcp dev main.py

発達

このサーバーは、モデルコンテキストプロトコル Python SDKを使用して構築されています。MCP および MCP サーバーの開発方法の詳細については、公式ドキュメントをご覧ください。

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

  1. リポジトリをクローンする
  2. 開発依存関係をインストールする
  3. 変更を加える
  4. MCPインスペクタを使用するか、Claude Desktopと統合してテストします。

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

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

  • 信頼できるクライアントのみで使用してください
  • 公開するファイルパスには注意してください
  • 実行前にすべてのコマンドを確認する

ライセンス

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

Install Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

View all tools

AI アシスタントが Ledger CLI を介して財務データを照会および分析し、財務レポート、予算分析、会計などのタスクを実行できるようにするモデル コンテキスト プロトコル サーバー。

  1. 概要
    1. 特徴
      1. 前提条件
        1. インストール
          1. uvの使用（推奨）
        2. 構成
          1. Claude Desktopでの使用
        3. 使用例
          1. デバッグ
            1. 発達
              1. セキュリティに関する考慮事項
                1. ライセンス

                  Related MCP Servers

                  • Flow MCP Server

                    lmcmz
                    -
                    security
                    F
                    license
                    -
                    quality
                    A Model Context Protocol server that enables AI assistants to access Flow blockchain data and perform operations such as checking balances, resolving domains, executing scripts, and submitting transactions.
                    Last updated -
                    JavaScript
                    • Linux
                    • Apple

                  • Chronos MCP Server

                    grandmastr
                    -
                    security
                    A
                    license
                    -
                    quality
                    A Model Context Protocol server for integrating AI assistants like Claude Desktop with the Stellar blockchain, enabling wallet connections, token listings, balance queries, and fund transfers.
                    Last updated -
                    5
                    JavaScript
                    MIT License
                    • Apple
                    • Linux

                  • Moneybird MCP Server

                    vanderheijden86
                    -
                    security
                    A
                    license
                    -
                    quality
                    A Model Context Protocol server that connects AI assistants like Claude to Moneybird accounting software, enabling management of contacts, financial data, products, and business operations through natural language.
                    Last updated -
                    1
                    JavaScript
                    MIT License
                    • Apple

                  • TON Access MCP Server

                    aiopinions
                    -
                    security
                    A
                    license
                    -
                    quality
                    A production-ready Model Context Protocol server implementation that connects AI assistants to the TON blockchain, allowing them to query wallet balances, transaction details, smart contracts, and other blockchain data.
                    Last updated -
                    TypeScript
                    MIT License

                  View all related MCP servers

                  Appeared in Searches

                  New MCP Servers

                  MCP directory API

                  We provide all the information about MCP servers via our MCP API.

                  curl -X GET 'https://glama.ai/api/mcp/v1/servers/minhyeoky/mcp-server-ledger'

                  If you have feedback or need assistance with the MCP directory API, please join our Discord server