広告掲載
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.

コメント

「その他」の他のコンテンツ

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

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

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K
広告掲載