Beamtrace

面向 Cursor 的 Beamtrace

Cursor 插件，可连接 Beamtrace 的远程 MCP，获取只读的 AI 可见性洞察。

还包括供 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）。此仓库还提供一个 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 位十六进制私钥（不是 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 账户，并在 beamtrace.com/setup 添加网站。

发布者：Elfsight。