BeanHub

BeanHub MCP

BeanHub のホスト型 MCP サーバーのファイル一覧です。このリポジトリはサーバーのソースではありません。稼働中のエンドポイントは https://api.beanhub.io/mcp です。

BeanHub は、Git 上でホストされる Beancount の帳簿です。AI アプリは OAuth でサインインすると、アカウントの一覧表示、取引の検索、残高の確認、許可した場合は台帳の更新を行えます。アプリでは CLI アクセストークンを使用しません。新しい接続は読み取り専用で開始します。

接続する前に、アカウントで MCP を有効にしてください：https://app.beanhub.io/mcp/。詳しい手順：MCP で AI アプリを接続する。

ファイル

各クライアントはそれぞれ固有のファイル名を参照します。すべて同じ URL を指しています。

ファイル	使用するもの
server.json	公式 MCP Registry（io.beanhub/mcp）
mcp.json	Cursor プラグインと Agent Plugins
.mcp.json	Claude Code プラグイン
plugin.json	Agent Plugins
.cursor-plugin/plugin.json	Cursor Marketplace
.claude-plugin/plugin.json	Claude Code プラグイン
.claude-plugin/marketplace.json	Claude Code マーケットプレイスカタログ
gemini-extension.json	Gemini CLI ギャラリー

https://app.beanhub.io/mcp/ を AI アプリに貼り付けないでください。このページは MCP の設定ページであり、サーバーではありません。

認証

サーバーは、動的クライアント登録と token_endpoint_auth_method=none を使用する OAuth 2.0 を採用しています。Bearer アクセストークンや固定のクライアントシークレットを追加しないでください。

アプリでできること

読み取りツール：list_books、list_accounts、search_transactions、get_balances、list_entries、get_entry、list_files、get_file、list_forms、list_commits。

書き込みツール（更新を有効にした場合のみ）：create_entries、update_entry、delete_entry、rename_account、submit_form、update_files。

アプリでは、アクセストークンの発行、請求内容の変更、銀行口座の接続、Connect または Inbox データのダンプ、帳簿の公開、帳簿の削除はできません。

公開ソース

公開版のコピーは https://github.com/LaunchPlatform/beanhub-mcp です。Cursor、Claude Code、Gemini CLI、および公式レジストリの repository.source フィールドでは、この GitHub リポジトリを使用します。

Amendable の更新を取り込み、GitHub にプッシュするには：

cd beanhub-mcp
git fetch origin
git merge origin/master
git push github master

Gemini CLI ギャラリーの場合は、GitHub トピック gemini-cli-extension を追加してください。

公式 MCP Registry

このリポジトリでは、ホスト型サーバー https://api.beanhub.io/mcp のメタデータのみを公開します。レジストリ名は io.beanhub/mcp です。この名前空間には、GitHub OIDC ではなく、beanhub.io での HTTP または DNS による証明が必要です。ドキュメント：リモートサーバー、認証、GitHub Actions。

mcp-publisher init は実行しないでください。server.json が上書きされます。

devenv

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

パブリッシャーキーは secrets.sops.yaml に保存され、PGP フィンガープリント A57616E62A499B512EDA662E0FC8D7008588874B を使用して SOPS で暗号化されています。後で編集するには sops secrets.sops.yaml を実行します。暗号化されたファイルはコミットし、key.pem はコミットしないでください。

公開証明は Hugo サイトから static/.well-known/mcp-registry-auth として配信されます。beanhub.io をデプロイし、https://beanhub.io/.well-known/mcp-registry-auth がその1行を返すようにしてください。DNS を使用する場合は、apex の beanhub.io に TXT レコードを設定します。その後、次を実行します：

mcp-publish

mcp-publish は MCP_PRIVATE_KEY（64 桁の16進数）を読み込み、./secrets.sops.yaml を復号化します。それがない場合は ./key.pem を使用します。デフォルトの認証方式は HTTP です。DNS を使う場合：MCP_AUTH_METHOD=dns mcp-publish。

devenv を使わない場合：

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

GitHub Actions

CI は、master へのプルリクエストとプッシュ時に ./scripts/validate-mcp.sh を実行します。

Publish to MCP Registry は、v* タグと workflow_dispatch で実行されます。mcp-registry-publish という名前の GitHub Environment を作成し、MCP_PRIVATE_KEY をリポジトリのシークレットではなく、環境のシークレットとして保存し、環境の対象を master とタグに制限します。その後、次の操作を行います。

git tag v1.0.0
git push github v1.0.0

タグ v1.0.0 を付けると、バージョン 1.0.0 が公開されます（コミット済みの server.json は書き換えられません）。バージョンは不変です。以降、メタデータのみを更新する場合はタグを新しくしてください。

次の内容を確認します。

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

リンク

• アプリ：https://app.beanhub.io
• ドキュメント：https://docs.beanhub.io/guides/mcp/
• プライバシー：https://beanhub.io/privacy-policy
• 利用規約：https://beanhub.io/terms-of-service
• サポート：[email protected]