MCP.so
登录

Beanquery MCP

@vanto

代码仓库

关于 Beanquery MCP

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

基本信息

分类

其他

许可证

MIT

运行时

python

传输方式

stdio

发布者

vanto

配置

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

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

工具

未检测到工具

工具是从 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

FAQ from Beanquery MCP

What are the prerequisites for Beanquery MCP?

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

How do I set the Beancount ledger file?

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

What tools does Beanquery MCP provide?

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

Is Beanquery MCP stable?

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

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 服务器

Core Philosophy: Connect, Unify, Respond

mindsdb

Delegate anything. It comes back done.

39.4K

AutoBrowser MCP

autobrowser-ai

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K

XcodeBuildMCP

cameroncooke

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0K

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K