MCP Server 配置指南

Rotifer MCP Server 让所有支持 MCP 的 Agent（Claude Desktop、Cursor、OpenClaw、Cline 等）能够直接访问整个 Gene 生态。

快速配置

在 Agent 的 MCP 配置中添加：

{
  "mcpServers": {
    "rotifer": {
      "command": "npx",
      "args": ["@rotifer/mcp-server"]
    }
  }
}

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "rotifer": {
      "command": "npx",
      "args": ["@rotifer/mcp-server"]
    }
  }
}

保存后重启 Claude Desktop。

Cursor

在项目根目录的 .cursor/mcp.json 中添加：

{
  "mcpServers": {
    "rotifer": {
      "command": "npx",
      "args": ["@rotifer/mcp-server"]
    }
  }
}

可用工具

工具	描述
`search_genes`	按名称、领域或保真度搜索 Gene 生态
`get_gene_detail`	获取 Gene 详细信息，包括表现型和适应度
`get_arena_rankings`	查看按 F(g) 排序的领域 Arena 排名
`compare_genes`	2-5 个 Gene 的适应度并排对比

使用示例

配置完成后，Agent 可以：

"搜索网页抓取相关的基因"
→ Agent 调用 search_genes({ query: "web scraping" })

"哪个搜索基因的适应度最高？"
→ Agent 调用 get_arena_rankings({ domain: "search.web" })

"对比这两个基因"
→ Agent 调用 compare_genes({ gene_ids: ["id1", "id2"] })

OpenClaw 集成

如果你使用 OpenClaw，Rotifer 可作为 MCP 类型的 Skill 使用。手动安装：

git clone https://gitlab.com/rotifer-protocol/rotifer-openclaw-skill.git \
  ~/.openclaw/workspace/skills/rotifer

重启 OpenClaw 后，使用 /rotifer 即可访问所有 Gene 生态工具。

WebMCP

WebMCP（Web Model Context Protocol）让浏览器端 AI Agent 能够直接从网页中发现和调用 Rotifer 工具——无需任何服务端配置。

工作原理

Rotifer 主站和 rotifer.ai 页面中嵌入了声明式 <form> 标签，向 WebMCP 兼容的 Agent 暴露可调用的工具：

<form hidden toolname="search_docs"
      tooldescription="搜索 Rotifer 协议文档">
  <input name="query" type="text"
         toolparamdescription="搜索关键词" />
</form>

当 Agent 访问 rotifer.dev 或 rotifer.ai 时，会自动发现这些工具并直接调用，无需手动配置。

可用 WebMCP 工具

页面	工具	描述
rotifer.dev	`search_docs`	搜索协议文档
rotifer.dev	`get_mcp_config`	获取 MCP Server 配置代码片段
rotifer.ai	`search_genes`	搜索 Gene 生态
rotifer.ai	`get_gene_detail`	按 ID 获取 Gene 详情
rotifer.ai	`get_arena_rankings`	查看 Arena 排名

浏览器支持

WebMCP 是 W3C 草案规范。目前支持实现了 Web MCP 规范的 Agent，包括浏览器扩展和具有网页浏览能力的 Agent 框架。

环境变量

变量	描述	默认值
`ROTIFER_CLOUD_ENDPOINT`	Cloud API 端点	`https://cloud.rotifer.dev`
`ROTIFER_CLOUD_ANON_KEY`	API 密钥	（内置）

系统要求

Node.js >= 20
互联网连接（需访问 Rotifer Cloud API）

常见问题

“Tool not found” 错误：确保 npx 在 PATH 中且 Node.js >= 20 已安装。

连接超时：检查网络连接。MCP Server 需要连接 cloud.rotifer.dev。

无搜索结果：Gene 生态处于 alpha 阶段。尝试更宽泛的搜索词，或使用 get_arena_rankings({}) 查看可用领域。