beanquery
一个让AI通过BQL查询Beancount账本数据的MCP服务器。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：beanquery。 它的用途是：一个让AI通过BQL查询Beancount账本数据的MCP服务器。 完整的 Skill 内容见：https://321skill.com/skills/beanquery/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我查一下上个月在“餐饮”和“交通”类别上的总支出分别是多少？'，它会通过本Skill查询你的Beancount账本，并返回清晰的分类汇总数据。或者你可以说：'显示我当前所有投资账户的余额和市值。'，AI会执行相应的BQL查询，并以表格或总结的形式呈现结果。
介绍
Beanquery Skill 是一个MCP（模型上下文协议）服务器，它解决了AI助手无法直接查询和分析Beancount复式记账账本数据的问题。通过集成beanquery工具和BQL（Beancount Query Language），它允许AI像访问数据库一样，对用户的财务账本进行复杂的查询和交互。
使用时，你需要将本Skill作为MCP服务器配置到你的AI客户端（如Claude Desktop、Cursor等），并指定你的Beancount账本文件路径。配置完成后，AI助手便获得了查询能力，你可以直接用自然语言让AI帮你分析财务状况，AI会在背后将你的需求转换为BQL查询并返回结果。
这个Skill非常适合使用Beancount进行个人或家庭财务管理的用户，尤其是那些希望利用AI的强大分析能力来洞察收支、资产、负债和投资情况的财务人员、量化交易员或对个人财务有精细化管理的专业人士。
使用前请确保你已安装并正确配置了Beancount和beanquery工具。由于Skill直接读取你的财务数据文件，请务必注意数据隐私和安全，仅在可信的本地环境中使用。初次配置时可能需要根据你的账本结构调整查询语句。
核心特点
它并非一个通用的财务分析工具，而是专门为Beancount账本设计的MCP桥接器，将BQL查询能力无缝集成到AI助手中，实现了用自然语言直接对话式查询复式记账数据的独特工作流。
注意事项
仅支持Beancount格式的账本文件，不适用于其他记账软件或格式的数据。
常见问题
什么是MCP服务器？
MCP（模型上下文协议）是一种让AI工具安全、结构化地访问外部数据和功能的协议，本Skill就是一个实现该协议的服务器，为AI提供查询能力。
需要提前安装Beancount吗？
是的，你必须先在本地系统安装并配置好Beancount以及beanquery命令行工具，本Skill依赖于它们来执行查询。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/beanquery/raw/index.md 读取 beanquery 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/beanquery/raw/index.md（查看排版版本）