Ledger MCP Server

分类帐服务MCP服务器

MCP服务器，用于通过Claude访问和管理分类账文件。

组件

工具

服务器实现了三种分类账管理工具：

• 列出帐户：列出分类账中的所有账户

- 将“year”作为必需参数 - 返回所有可用帐户的格式化列表

• 账户余额：获取特定帐户的余额

- 将“year”和“account”作为必需参数 - 返回指定帐户的当前余额

• 账户登记簿：显示帐户的交易登记簿

- 将“year”和“account”作为必需参数 - 返回指定帐户的详细交易历史记录

安装

先决条件

• Python 3.13或更高版本
• uv 包管理器
• Node.js和npm（用于调试）

从PyPI安装

uv pip install ledger-service

调试

使用检查器调试服务器：

npx @modelcontextprotocol/inspector \
  uv \
  --directory /path/to/ledger-service \
  run \
  ledger-service

MCP Inspector debugging interface

配置Claude桌面

将服务器配置添加到Claude Desktop的配置文件中：

在MacOS上： ~/Library/Application\ Support/Claude/claude_desktop_config.json 在Windows上： %APPDATA%/Claude/claude_desktop_config.json

Development Configuration

"mcpServers": {
  "ledger-service": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/ledger-service",
      "run",
      "ledger-service"
    ]
  }
}

Production Configuration

"mcpServers": {
  "ledger-service": {
    "command": "uvx",
    "args": [
      "ledger-service"
    ]
  }
}

发展

本地设置

1. 克隆存储库
2. 创建并激活虚拟环境
3. 安装依赖项：

可以通过修改来配置基本路径 LEDGER_BASE_PATH 常数in server.py.

许可证

GNU通用公共许可证版本32007年6月29日