让你的 AI Agent 接入轮虫生态

你的 AI Agent 已经很擅长写代码了——但如果它还能自己发现、评估、安装模块化的逻辑单元呢？接入 Rotifer 基因生态正是为此而生。

注册表中已有 50 多个基因，你的 Agent 可以搜索网页抓取基因、按适应度比较多个方案、然后把最优解拉进你的项目——整个过程在一次对话中完成，无需切换浏览器，无需复制粘贴。

本教程带你在五分钟内完成配置。

前置条件

• Node.js 20+ — MCP Server 通过 npx 运行，需要现代 Node 运行时。
• 以下 AI 客户端之一：
  • Claude Desktop（macOS / Windows）
  • Cursor IDE
  • OpenClaw AI Agent 平台

不需要 API 密钥，不需要注册账号——Rotifer 公共注册表完全开放。

Claude Desktop 配置

Claude Desktop 在启动时从 JSON 配置文件加载 MCP 服务器。

1. 打开配置文件

macOS 路径：

~/Library/Application Support/Claude/claude_desktop_config.json

Windows 路径：

%APPDATA%\Claude\claude_desktop_config.json

如果文件不存在，手动创建即可。

2. 添加 Rotifer 服务器

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

如果你已经配置了其他 MCP 服务器，在 mcpServers 中并列添加 "rotifer" 即可。

3. 重启 Claude Desktop

退出并重新打开应用。聊天输入区域会出现锤子图标（🔨），表示 MCP 工具已就绪。点击图标确认 rotifer 工具出现在列表中。

Cursor 配置

Cursor 从项目根目录的 .cursor/mcp.json 文件读取 MCP 配置。

1. 创建配置文件

mkdir -p .cursor
touch .cursor/mcp.json

2. 添加 Rotifer 服务器

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

3. 重载窗口

打开命令面板（Cmd+Shift+P / Ctrl+Shift+P），执行 Developer: Reload Window。Cursor 会在后台启动 MCP 服务器。你可以在设置中的 MCP 面板验证运行状态。

OpenClaw 配置

OpenClaw 使用技能（Skill）扩展模型。Rotifer 提供了官方 OpenClaw Skill。

1. 克隆技能仓库

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

2. 重启 OpenClaw

平台在启动时自动发现新技能。重启后，你可以在任何对话中使用 /rotifer 斜杠命令。

3. 试一下

/rotifer search web scraping

OpenClaw 会调用 Rotifer 注册表并内联返回匹配的基因列表。

上手体验

服务器连接成功后，用自然语言和你的 Agent 对话即可。以下是几个入门提示词：

搜索注册表

“搜索网页抓取相关的基因”

Agent 会调用 list_genes，传入查询词 "web scraping"，返回匹配基因的名称、描述和适应度分数。

找到最优选择

“哪个搜索基因的适应度最高？”

Agent 会调用 get_leaderboard 或带排序参数的 list_genes，告诉你 Arena 排名最高的基因。

对比方案

“对比 gene-http-fetch 和 gene-browser-scraper”

Agent 会调用 compare_genes，传入两个基因 ID，展示并排对比：适应度分数、输入输出 Schema、保真度等级（Native vs Wrapped）、下载量。

查看统计

“显示 gene-http-fetch 最近 30 天的下载趋势”

Agent 会调用 get_gene_stats，指定时间范围，然后总结趋势。

可用 MCP 工具

你的 Agent 获得的完整工具列表：

除 run_gene 外，所有工具均为只读操作。run_gene 在 Rotifer 的沙箱化 Cloud Binding 中执行基因。

常见问题

“Tool not found” 或 MCP 服务器无法启动

• 检查 Node.js 版本：node -v 应输出 v20.x 或更高。
• 确认 npx 可用：npx --version。
• 直接运行服务器以查看错误信息：npx @rotifer/mcp-server。

“Connection timeout”（连接超时）

• 服务器需要连接 cloud.rotifer.dev，确保网络可达。
• 如果你在公司代理后面，在启动 AI 客户端前设置 HTTPS_PROXY 环境变量。

搜索返回空结果

• 基因生态目前处于 Alpha 阶段——注册表已有 50 多个基因，但覆盖范围仍在增长中。尝试更宽泛的搜索词（例如用 "http" 代替 "REST API JSON 解析器"）。
• 不带查询词调用 list_genes 可以浏览所有可用基因。

接下来

你的 AI Agent 现在已经和 Rotifer 基因生态建立了实时连接。注册表中的每一个基因——现有的和未来的——都能被你的 Agent 即时访问，无需任何插件更新。

试着构建点什么：让你的 Agent 找到一个基因、检查它的详情、然后集成到你的项目中。用得越多，体验越自然。

深入阅读： 查看完整的 MCP Server 设置指南，了解高级配置与 WebMCP 详情。