MCP 服务器

Ledger CLI MCP Server

一个模型上下文协议服务器，允许 AI 助手通过 Ledger CLI 查询和分析财务数据，从而实现财务报告、预算分析和会计等任务。 (Simplified version, focusing on clarity and common usage:) 一个模型上下文协议服务器，让 AI 助手可以通过 Ledger CLI 查询和分析财务数据，进行财务报告、预算分析和会计等工作。

README

mcp-server-ledger: Ledger CLI MCP 服务器

概述

一个模型上下文协议 (Model Context Protocol, MCP) 服务器，用于与 Ledger CLI 交互。Ledger CLI 是一个强大的复式记账系统，可以通过命令行访问。此服务器允许大型语言模型通过 Ledger CLI 工具查询和分析您的财务数据。

此 MCP 服务器通过标准化接口公开 Ledger CLI 的功能，使 AI 助手可以轻松地帮助您进行财务报告、预算分析和会计任务。

功能

该服务器提供以下工具，这些工具映射到 Ledger CLI 命令：

ledger_balance
- 显示账户余额，具有强大的过滤选项
- 输入：查询模式、日期范围、显示选项
- 返回：格式化的余额报告
ledger_register
- 显示交易登记，包含详细历史记录
- 输入：查询模式、日期范围、排序选项
- 返回：格式化的登记报告
ledger_accounts
- 列出账簿文件中的所有账户
- 输入：可选的查询模式
- 返回：匹配账户的列表
ledger_payees
- 列出交易中的所有收款人
- 输入：可选的查询模式
- 返回：匹配收款人的列表
ledger_commodities
- 列出所有使用的商品（货币）
- 输入：可选的查询模式
- 返回：匹配商品的列表
ledger_print
- 以 ledger 格式打印交易
- 输入：查询模式、日期范围
- 返回：格式化的 ledger 条目
ledger_stats
- 显示关于账簿文件的统计信息
- 输入：可选的查询模式
- 返回：账簿的统计摘要
ledger_budget
- 显示预算分析
- 输入：查询模式、日期范围、报告周期
- 返回：预算报告
ledger_raw_command
- 运行原始的 Ledger CLI 命令
- 输入：命令参数作为字符串列表
- 返回：命令输出作为文本

前提条件

必须安装 Ledger CLI 并且可以在您的 PATH 中访问
包含您的财务数据的有效 Ledger 文件

安装

使用 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",  // 可选：设置 LEDGER_FILE
      "--with",
      "mcp[cli]",
      "mcp",
      "run",
      "<repo_path>/main.py"  // 此存储库中 main.py 文件的路径
    ]
  }

}