BeanHub

io.beanhub由 beanhub.io 发布官方发布者v1.0.0更新于 Oct 24, 2026

Read and update hosted Beancount books over OAuth. No CLI access token.

已验证Streamable HTTP可网页运行效率与工作流金融

概览

AI 生成的概览

BeanHub 的托管 MCP 服务器，让助手通过 OAuth 读取 Beancount 账本的账户、交易和余额，并可选地更新账本。

可以做什么
列出托管 Beancount 账本中的账簿、账户、分录、文件、表单和提交记录，并读取单条分录和文件。搜索交易并查看账户余额。开启更新后，可创建、修改和删除分录，重命名账户，提交表单并更新文件。
适用场景
当你的记账数据存放在 BeanHub 托管的 Beancount 账本中，并希望 AI 助手查询交易、余额和分录，或在你明确允许时修改账本时使用。
运行要求
需要 BeanHub 账户，并在账户的 MCP 设置中启用 MCP，同时由 AI 应用完成 OAuth 2.0 登录（动态客户端注册，无需客户端密钥）。服务器为远程端点，无需本地运行时或访问令牌。
安装前请注意
开启更新后，写入工具可创建、修改和删除账本分录、重命名账户、提交表单并更新文件；新连接默认只读，除非确实需要编辑，否则请保持只读。应用无法更改账单、连接银行、公开账本或删除账本。仅支持 OAuth 登录，不要添加 Bearer 令牌或静态客户端密钥。

安装

在 SourceWeft 中

  1. 打开 控制台中的 BeanHub，将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.beanhub%2Fmcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "beanhub": {
      "type": "http",
      "url": "https://api.beanhub.io/mcp"
    }
  }
}

README

BeanHub MCP

Listing files for BeanHub's hosted MCP server. This repository is not the server source. The live endpoint is https://api.beanhub.io/mcp.

BeanHub is a hosted Beancount book on Git. An AI app signs in with OAuth, then can list accounts, search transactions, check balances, and update the ledger if you allow it. The app does not use a CLI access token. New connections start read-only.

Enable MCP on your account before you connect: https://app.beanhub.io/mcp/. Full steps: Connect an AI app with MCP.

Files

Each client looks for its own filename. They all point at the same URL.

FileUsed by
server.jsonOfficial MCP Registry (io.beanhub/mcp)
mcp.jsonCursor plugins and Agent Plugins
.mcp.jsonClaude Code plugins
plugin.jsonAgent Plugins
.cursor-plugin/plugin.jsonCursor Marketplace
.claude-plugin/plugin.jsonClaude Code plugins
.claude-plugin/marketplace.jsonClaude Code marketplace catalog
gemini-extension.jsonGemini CLI gallery

Do not paste https://app.beanhub.io/mcp/ into an AI app. That page is MCP settings, not the server.

Auth

The server uses OAuth 2.0 with dynamic client registration and token_endpoint_auth_method=none. Do not add a Bearer access token or a static client secret.

What the app can do

Read tools: list_books, list_accounts, search_transactions, get_balances, list_entries, get_entry, list_files, get_file, list_forms, list_commits.

Write tools (only if you turn on updates): create_entries, update_entry, delete_entry, rename_account, submit_form, update_files.

The app cannot mint access tokens, change billing, connect a bank, dump Connect or Inbox data, make a book public, or delete a book.

Public source

The public copy is https://github.com/LaunchPlatform/beanhub-mcp. Cursor, Claude Code, Gemini CLI, and the official registry repository.source field use that GitHub repo.

To pull Amendable updates and push GitHub:

bash
cd beanhub-mcpgit fetch origingit merge origin/mastergit push github master

For Gemini CLI gallery, add the GitHub topic gemini-cli-extension.

Official MCP Registry

This repo publishes metadata only for the hosted server https://api.beanhub.io/mcp. The registry name is io.beanhub/mcp. That namespace needs HTTP or DNS proof on beanhub.io, not GitHub OIDC. Docs: remote servers, authentication, GitHub Actions.

Do not run mcp-publisher init. It would overwrite server.json.

devenv

bash
direnv allow   # or: devenv shellmcp-validatemcp-gen-auth   # encrypts MCP_PRIVATE_KEY into secrets.sops.yaml + gitignored mcp-registry-auth

The publisher key is stored in secrets.sops.yaml, encrypted with SOPS using PGP fingerprint A57616E62A499B512EDA662E0FC8D7008588874B. Edit later with sops secrets.sops.yaml. Commit the encrypted file; do not commit key.pem.

The public proof is served from the Hugo site as static/.well-known/mcp-registry-auth. Deploy beanhub.io so https://beanhub.io/.well-known/mcp-registry-auth returns that one line. DNS alternative: TXT on the apex beanhub.io. Then:

bash
mcp-publish

mcp-publish reads MCP_PRIVATE_KEY (64 hex chars), decrypts ./secrets.sops.yaml, or falls back to ./key.pem. Default auth method is HTTP. For DNS: MCP_AUTH_METHOD=dns mcp-publish.

Without devenv:

bash
./scripts/validate-mcp.sh./scripts/gen-mcp-registry-auth.sh./scripts/publish-mcp.sh

GitHub Actions

CI runs ./scripts/validate-mcp.sh on pulls and pushes to master.

Publish to MCP Registry runs on v* tags and on workflow_dispatch. Create a GitHub Environment named mcp-registry-publish, store MCP_PRIVATE_KEY as an environment secret (not a repo secret), and restrict the environment to master and tags. Then:

bash
git tag v1.0.0git push github v1.0.0

A tag v1.0.0 publishes version 1.0.0 (the committed server.json is not rewritten). Versions are immutable. Bump the tag for later metadata-only updates.

Confirm:

bash
curl -sS "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.beanhub/mcp"

Links

来源：README.md，提交 494ab90

工具

0
该服务器需要登录，因此 SourceWeft 无法在没有账号的情况下读取其工具，也未收录。已连接账号所能看到的内容可能因账号及其权限而异。

版本历史

1
  1. v1.0.0最新Sep 21, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分