Ledger CLI MCP Server

mcp服务器分类账：一个分类账CLI mcp服务器

概述

一种用于交互的模型上下文协议服务器 Ledger CLI，一个功能强大的复式记账系统，可从命令行访问。此服务器允许大型语言模型通过Ledger CLI工具查询和分析您的财务数据。

此MCP服务器通过标准化界面公开Ledger CLI的功能，使AI助手能够轻松帮助您完成财务报告、预算分析和会计任务。

特性

服务器提供以下映射到Ledger CLI命令的工具：

1. ledger_balance

- 使用强大的过滤选项显示帐户余额 - 输入：查询模式、日期范围、显示选项 - 退货：格式化余额报告

1. ledger_register

- 显示具有详细历史记录的交易登记簿 - 输入：查询模式、日期范围、排序选项 - 返回：格式化注册表报告

1. ledger_accounts

- 列出分类账文件中的所有账户 - 输入：可选查询模式 - 返回：匹配帐户列表

1. ledger_payees

- 列出交易中的所有收款人 - 输入：可选查询模式 - 返回：匹配的收款人列表

1. ledger_commodities

- 列出所有使用的商品（货币） - 输入：可选查询模式 - 退货：匹配商品列表

1. ledger_print

- 以分类账格式打印交易记录 - 输入：查询模式、日期范围 - 返回：格式化分类账条目

1. ledger_stats

- 显示分类账文件的统计信息 - 输入：可选查询模式 - 返回：分类账的统计摘要

1. ledger_budget

- 显示预算分析 - 输入：查询模式、日期范围、报告期 - 返回：预算报告

1. ledger_raw_command

- 运行原始Ledger CLI命令 - 输入：命令参数为字符串列表 - 返回：命令输出为文本

先决条件

• Ledger CLI 必须在PATH中安装并可用
• 包含您财务数据的有效分类账文件

安装

使用Docker（推荐）

您还可以使用minhyeoky/mcp分类账存储库中的Docker镜像：

docker pull minhyeoky/mcp-ledger

将此添加到您的 claude_desktop_config.json:

"mcp-ledger": {
  "command": "docker",
  "args": [
    "run",
    "-v",
    "/path/to/your/ledger/file.ledger:/main.ledger",
    "-e",
    "LEDGER_FILE=/main.ledger",
    "-i",
    "--rm",
    "minhyeoky/mcp-ledger"
  ]
}

替换 /path/to/your/ledger/file.ledger 带有分类账文件的实际路径。

通过Smithery安装

通过以下方式自动安装Ledger CLI MCP Server for Claude Desktop 史密瑟里:

npx -y @smithery/cli install @minhyeoky/mcp-ledger --client claude

使用紫外线

安装和运行此服务器的最简单方法是 紫外线:

uv sync

配置

服务器需要您的分类账文件的路径。这可以通过以下方式提供：

• 这 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",
      "/main.py"  // Path to the main.py file in this repository
    ]
  }

}

使用示例

配置后，您可以向AI助手询问有关财务数据的问题：

• “给我看看上个月的开支”
• “我目前所有账户的余额是多少？”
• “列出与亚马逊的所有交易”
• “2023年我在杂货上花了多少钱？”
• “显示我第一季度的预算绩效”

AI将通过服务器使用适当的Ledger CLI命令来获取信息。

调试

有关更详细的本地测试：

mcp dev main.py

发展

为该项目做出贡献：

1. 克隆存储库
2. 安装开发依赖项
3. 进行更改
4. 使用MCP检查器或通过与Claude Desktop集成进行测试

安全考虑

此服务器对您的财务数据运行Ledger CLI命令。虽然它包括防止命令注入的基本验证，但您应该：

• 仅与受信任的客户端一起使用
• 小心你暴露的文件路径
• 执行前检查所有命令

许可证

此MCP服务器根据MIT许可证获得许可。您可以根据许可条款自由使用、修改和分发它。