Bittlebits.ai Mcp

Bittlebits MCP 服务

一个 Model Context Protocol 服务，可将你的 Bittlebits GEO 评分和改写建议直接带入 AI Agent——Claude Code、Cursor、VS Code、Codex，或任何兼容 MCP 的客户端。

无需来回复制内容，你的 Agent 就能获取 Bittlebits 的建议，并直接在代码库中应用这些更改。

---

快速开始

npx @bittlebits.ai/mcp setup

按照以下步骤即可完成设置：

1. 选择客户端 — Claude Code、Cursor、VS Code、Codex（可任意组合）。
2. 登录 — 浏览器窗口会打开；登录 Bittlebits 即可。你的 API 密钥会获取并缓存在本地的 ~/.bittlebits/config.json 中。
3. 已连接 — 服务配置会写入各客户端的配置文件。重启客户端，然后就可以开始提问。

无需复制粘贴密钥，也无需手动编辑 JSON。

已有 API 密钥？跳过浏览器： npx @bittlebits.ai/mcp setup --api-key bb_your_key

---

你可以做什么

连接后，可以向你的 Agent 提出以下问题：

• “告诉我 Bittlebits 建议如何修改此页面，并说明原因。”
• “应用 Bittlebits 的建议，改写我的主页文案。”
• “哪些指标最弱？我应该先修复什么？”
• “获取我的着陆页评分，然后在代码库中找到对应文件并更新。”

---

可用工具

工具	功能
get_score	返回页面的 GEO 指标评分（每个维度为 0–10 分）
get_rewrite	返回原始页面内容，以及应用 Bittlebits 建议后改写的内容
get_url_content	返回 Bittlebits 获取的页面原始 HTML 和 Markdown 内容

所有工具都接受 url（完整页面 URL）或 url_id（已知时使用的 Bittlebits 内部 ID）。首次运行时，Bittlebits 处理页面可能需要几分钟。

---

setup 命令

npx @bittlebits.ai/mcp setup [options]

  --claude --cursor --vscode --codex   Configure specific clients (skips the menu)
  -p, --project                        Write project-scoped config (current directory)
  --global                             Write user-global config
  --api-key <key>                      Use this key instead of signing in
  -y, --yes                            Non-interactive (use flags/defaults)

各客户端配置文件的写入位置：

客户端	项目范围	全局范围
Claude Code	.mcp.json	~/.claude.json
Cursor	.cursor/mcp.json	~/.cursor/mcp.json
VS Code	.vscode/mcp.json	用户级 mcp.json
Codex	.codex/config.toml	~/.codex/config.toml

重新运行 setup 是安全的：它会合并到现有文件中，保留其他 MCP 服务，并且只更新 Bittlebits 条目。

---

launch 命令

已经运行过 setup？使用 launch，即可立即启动预加载了 Bittlebits 的 AI 会话——无需手动配置。

npx @bittlebits.ai/mcp launch

该命令会检测你的机器上已安装的 AI 客户端（Claude Code、Codex），并启动会话。如果检测到两者，系统会提示你选择一个。

npx @bittlebits.ai/mcp launch [options]

  -c, --client <name>   Force a specific client: claude, codex
  -p, --prompt <text>   Send an initial prompt (non-interactive / scripted use)

示例：

# Interactive session with auto-detected client
npx @bittlebits.ai/mcp launch

# Force Claude Code
npx @bittlebits.ai/mcp launch --client claude

# One-shot score in your terminal
npx @bittlebits.ai/mcp launch --client claude --prompt "Get the GEO score for nike.com"

---

手动配置

想要自行接入？任何支持 stdio 传输的客户端都可以使用。在环境中设置 BITTLEBITS_API_KEY 后运行 npx bittlebits-mcp——你可以在 bittlebits.ai 的 Settings → API Keys 中找到密钥。

Claude Code（CLI）：

claude mcp add --transport stdio bittlebits -e BITTLEBITS_API_KEY=your_key -- npx -y @bittlebits.ai/mcp

Cursor / Claude Code（.cursor/mcp.json 或 .mcp.json）：

{
  "mcpServers": {
    "bittlebits": {
      "command": "npx",
      "args": ["-y", "@bittlebits.ai/mcp"],
      "env": { "BITTLEBITS_API_KEY": "your_key_here" }
    }
  }
}

VS Code（.vscode/mcp.json）：

{
  "servers": {
    "bittlebits": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@bittlebits.ai/mcp"],
      "env": { "BITTLEBITS_API_KEY": "your_key_here" }
    }
  }
}

Codex（~/.codex/config.toml）：

[mcp_servers.bittlebits]
command = "npx"
args = ["-y", "@bittlebits.ai/mcp"]

[mcp_servers.bittlebits.env]
BITTLEBITS_API_KEY = "your_key_here"

---

前置条件

• Node.js 18+
• 一个 Bittlebits 账户

---

开发

git clone https://github.com/bittlebitsai/bittlebits-mcp
cd bittlebits-mcp  # local dev still uses the folder name
npm install
npm run dev       # run the server with tsx (no build step)
npm run build     # compile to dist/

# Try the setup flow
node dist/index.js setup

环境变量：

• BITTLEBITS_API_KEY — 服务模式的 API 密钥（跳过浏览器登录）。

---

提示

• 明确说明要保留的内容。 如果品牌语调很重要，请告诉你的 Agent：“应用这些建议，但保留轻松、对话式的语气。”
• 对于较长的页面，按章节逐步处理——更便于审核。
• 编辑后重新评分。 更新页面后，触发一次新的 Bittlebits 评分，查看指标提升了多少。