广告合作
MCP.so
登录

Beanquery MCP Server

@vanto

代码仓库

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

vanto

关于 Beanquery MCP Server

Beancount MCP Server is an experimental implementation that utilizes the Model Context Protocol (MCP) to enable AI assistants to query and analyze Beancount ledger files using Beancount Query Language (BQL) and the beanquery tool.

#personal-finance#mcp#beancount#plaintext-accounting#plaintextaccounting#model-context-protocol#mcp-server

Beanquery MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "beanquery-mcp": {
      "command": "uv",
      "args": [
        "run",
        "mcp",
        "install",
        "server.py",
        "-v",
        "BEANCOUNT_LEDGER=$(pwd)/sample.bean",
        "--with",
        "beancount",
        "--with",
        "beanquery"
      ]
    }
  }
}

Beanquery MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Beanquery MCP?

Beanquery MCP is an experimental Model Context Protocol (MCP) server that interfaces with Beancount ledger files. It uses the Beancount Query Language (BQL) and the beanquery tool to enable querying and analysis of financial data, allowing AI assistants to interact with Beancount ledgers through a standardized protocol.

How to use Beanquery MCP?

Install with Python 3.10+ and uv (recommended). Run in development mode using mcp dev server.py. Install into Claude Desktop with mcp install server.py, optionally setting the BEANCOUNT_LEDGER environment variable. Use the run_query tool to execute BQL queries and the set_ledger_file tool to specify a ledger file. Access resources at beanquery://tables and beanquery://accounts.

Key features of Beanquery MCP?

  • Run BQL queries against Beancount ledger files
  • Set ledger file via tool or environment variable
  • List accessible BQL tables and accounts
  • Integrates with MCP for AI assistant communication
  • Works with Claude Desktop after installation

Use cases of Beanquery MCP?

  • Query financial data from a Beancount ledger using natural language via an AI assistant
  • Retrieve a list of accounts or tables for analysis
  • Test and debug Beancount queries interactively with MCP Inspector

常见问题

1

What are the prerequisites for Beanquery MCP?

Python 3.10 or later and uv (recommended) for managing the project.

2

How do I set the Beancount ledger file?

Use the `set_ledger_file` tool or set the `BEANCOUNT_LEDGER` environment variable when installing.

3

What tools does Beanquery MCP provide?

It provides `run_query` to run BQL queries and `set_ledger_file` to specify the ledger file.

4

Is Beanquery MCP stable?

No, the server is experimental and may undergo significant changes. Use in a development environment.

5

Does Beanquery MCP send my financial data to third parties?

Yes, parts of your ledger may be transmitted to LLM providers via MCP. The README includes a privacy warning and recommends caution, especially with sensitive data.

评论

其他 分类下的更多 MCP 服务器

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K

The Living Bread

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

广告合作