Beamtrace

Cursor 向け Beamtrace

読み取り専用の AI 可視性インサイトを提供する Beamtrace のリモート MCP に接続する Cursor プラグインです。

MCP Registry 向けの server.json（リモート専用）と、カタログ用 Docker ビルドで使用する stdio イントロスペクションシムも含まれています。

含まれる内容

• MCP：https://beamtrace.com/api/mcp（OAuth；組織のウェブサイトは自動的に解決されます）
• ルール：メトリクスの解釈方法と、人に向けたレポートの表現方法

ツール

ツール	目的
get_visibility	全体的な可視性スコアとインサイト
list_topics	トピックごとの集計
list_prompts	プロンプト単位のメトリクスとカバレッジの不足
list_competitors	可視性のランキング
list_improvements	優先順位付けされたコンテンツ改善案

stdio カタログイメージ

製品版 MCP はリモート（https://beamtrace.com/api/mcp）です。このリポジトリには、同じ 5 つのツールを一覧表示する stdio シムも含まれているため、Docker イメージを起動してイントロスペクション（initialize / tools/list）に応答できます。このシムは Beamtrace API を呼び出しません。

docker build -t beamtrace-mcp .
docker run -i --rm beamtrace-mcp

検証

pnpm validate

Pre-commit は Lefthook 経由で同じチェックを実行します（クローン後に pnpm exec lefthook install を実行してください）。

ローカルインストール（開発用）

ln -sf "$(pwd)" ~/.cursor/plugins/local/beamtrace

Cursor を再読み込み → カスタマイズ → Beamtrace が読み込まれていることを確認 → MCP で認証します。

リリース

v* タグ（例：v1.0.1）をプッシュすると、.github/workflows/publish-mcp.yml が実行されます。HTTP ドメイン認証でログインした後、次の処理を行います。

node scripts/publish.mjs --target all --version "$GITHUB_REF_NAME" --yes

これにより、.cursor-plugin/plugin.json と server.json がタグのバージョンに設定され（v 接頭辞は削除されます）、MCP Registry に公開されます。その後、変更があった場合は、これらのファイルをデフォルトブランチにコミットします。タグ自体は元のコミットに残ります。

リポジトリのシークレット MCP_PRIVATE_KEY を追加してください。これは mcp-publisher login http で使用する 64 文字の 16 進数形式の秘密鍵です（PEM ファイルではありません）。

git tag v1.0.1
git push origin v1.0.1

ローカル／対話形式の場合（最初に mcp-publisher をインストールしてください）：

pnpm release

cursor ／ mcp registry ／ all を選び、次に patch ／ minor ／ major を選択するか、--version を渡します。Cursor では .cursor-plugin/plugin.json のみが更新されます。MCP では mcp-publisher publish も実行されます。

pnpm release -- --target cursor --bump patch --yes
pnpm release -- --target mcp --bump minor --yes
pnpm release -- --target all --bump patch --yes
pnpm release -- --target all --version 1.0.1 --yes

名前空間 com.beamtrace/mcp には、beamtrace.com のドメイン認証が必要です（ドキュメント）。ローカルでのログインには pnpm registry:login:http を使用してください。GitHub が所有する名前空間の場合に限り、pnpm registry:login:github を使用してください。

公開時には、server.json のバージョンを稼働中の MCP の serverInfo.version と一致させてください。

認証

インストール後、Cursor から求められたら Beamtrace へのサインインを完了してください。beamtrace.com/setup でウェブサイトを登録した Beamtrace アカウントが必要です。

公開元：Elfsight。