ledger-service MCP server
2025.02.23
3
Python财务管理账本查询交易记录查看金融服务
ledger-mcp-server 是一个用于通过 Claude 访问和管理账本文件的 MCP 服务器。它提供了三个核心工具来管理账本，包括列出账户、获取账户余额和查看账户交易记录。该服务适用于需要管理财务账本的用户，特别是那些希望通过 Claude 进行账本操作的用户。
View on GitHub
Overview
基本能力
产品定位
ledger-mcp-server 是一个用于通过 Claude 访问和管理账本文件的 MCP 服务器。
核心功能
- list-accounts: 列出账本中的所有账户
- 需要参数 "year"
- 返回所有可用账户的格式化列表
- account-balance: 获取特定账户的余额
- 需要参数 "year" 和 "account"
- 返回指定账户的当前余额
- account-register: 显示账户的交易记录
- 需要参数 "year" 和 "account"
- 返回指定账户的详细交易历史
适用场景
- 财务管理
- 账本查询
- 交易记录查看
工具列表
- list-accounts: 列出账本中的所有账户
- account-balance: 获取特定账户的余额
- account-register: 显示账户的交易记录
常见问题解答
- 如何配置 Claude Desktop 以使用该服务？
- 在 MacOS 上：
~/Library/Application\ Support/Claude/claude_desktop_config.json - 在 Windows 上：
%APPDATA%/Claude/claude_desktop_config.json
使用教程
使用依赖
- Python 3.13 或更高版本
uv包管理器- Node.js 和 npm（用于调试）
安装教程
uv pip install ledger-service
调试方式
npx @modelcontextprotocol/inspector \
uv \
--directory /path/to/ledger-service \
run \
ledger-service
本地开发设置
- 克隆仓库
- 创建并激活虚拟环境
- 安装依赖
可以通过修改 server.py 中的 LEDGER_BASE_PATH 常量来配置基础路径。