beanquery-mcp

概述

Beanquery MCP 服务器通过模型上下文协议将 AI 助手与 Beancount 财务账本连接起来。它提供了设置账本文件和运行 BQL 查询的工具，以及访问账户和表格信息的资源。这个实验性实现能够使 AI 分析 Beancount 格式的财务数据，尽管它仍在发展中，可能会有重大变化。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• set_ledger_file

  Set the Beancount ledger file to use for queries.

  试试:Set the ledger file to /path/to/my/ledger.bean试试:Use sample.bean for queries
• run_query

  Run a BQL query against the loaded Beancount file.

  试试:Show all transactions from January 2023试试:Calculate total expenses this year

可对比工具

安装

mcp dev server.py

uv run mcp install server.py --with beancount --with beanquery

uv run mcp install server.py -v BEANCOUNT_LEDGER=/path/to/your/ledger.bean --with beancount --with beanquery

{
  "mcpServers": {
    "beancount": {
      "command": "uv",
      "args": ["run", "mcp", "install", "server.py"],
      "env": {
        "BEANCOUNT_LEDGER": "/path/to/your/ledger.bean"
      }
    }
  }
}

FAQ

这个服务器是否可用于生产环境？

不，这是一个实验性实现，可能会发生重大变化。建议在开发环境中使用它。

我需要注意哪些数据隐私问题？

此工具可能会将您的 Beancount 账本部分内容传输给第三方 LLM 服务。请谨慎处理敏感财务数据，考虑在测试账本中隐藏信息，并在可能的情况下优先选择自托管 LLM。

beanquery-mcp 对比