Beanquery MCP
2025.04.01
12
Python财务数据分析财务管理工具金融服务
Beanquery MCP 是一个实验性的 Model Context Protocol (MCP) 实现，旨在与 Beancount 账本文件进行交互。它利用 Beancount Query Language (BQL) 和 beanquery 工具，实现对 Beancount 格式财务数据的查询和分析。通过集成 MCP，该服务器促进了 AI 助手与 Beancount 账本之间的标准化通信，增强了财务数据的可访问性和实用性。
View on GitHub
Overview
基本能力
产品定位
Beanquery MCP 是一个财务数据查询和分析工具，专为 Beancount 账本设计，通过 MCP 协议与 AI 助手进行交互。
核心功能
- 支持 Beancount Query Language (BQL) 查询
- 提供
set_ledger_file和run_query工具 - 支持通过 MCP 协议与 AI 助手交互
适用场景
- 财务数据分析
- 个人或企业财务管理
- AI 助手与财务数据的交互
工具列表
set_ledger_file: 设置用于查询的 Beancount 账本文件run_query: 对加载的 Beancount 文件运行 BQL 查询
常见问题解答
- 隐私警告: 该工具可能将账本中的部分数据（包括潜在的机密或私人财务信息）传输给第三方服务。建议在使用时注意数据安全。
使用教程
使用依赖
- Python 3.10 或更高版本
- uv 用于管理 Python 项目（推荐）
安装教程
-
开发模式:
bash mcp dev server.py -
Claude Desktop 集成:
- 快速启动:
bash uv run mcp install server.py -v BEANCOUNT_LEDGER=$(pwd)/sample.bean --with beancount --with beanquery - 自定义名称:
bash uv run mcp install server.py --name "Beanquery MCP Server" --with beancount --with beanquery - 环境变量:
bash uv run mcp install server.py -v BEANCOUNT_LEDGER=/path/to/your/ledger.bean --with beancount --with beanquery uv run mcp install server.py -f .env --with beancount --with beanquery
调试方式
运行测试套件:
pytest server_test.py