Rabbit R1 SDK Idea Helper MCP

兔子R1创意MCP

主控程序 服务器：

• 生成并记住 兔R1创意 应用程序创意（由官方支持 创作sdk GitHub上的repo）。
• 拉动a 单发知识指数 在一个工具调用中：官方Creations SDK+社区 r1创建 加上您注册的任何URL 在本地文档库中（合并到相同的有效负载中）。
• 可选地 出版 每个来源 SKILL.md 存根和共享清单 Tourettes99/r1-sdk-idea-helper-mcp 在...之下 library/ （需要GitHub PAT和repo写入）。

Node.js 18+ 必需（全局 fetch).

个人技能引导（建议每台机器一次）

因此，代理商从不将“缺少技能路径”视为复制的理由 其他 repos（例如meshy-print-r1）：

• 运行存根生成器 （每个克隆的结果都相同）：

cd rabbit-ideas-mcp
npm run bootstrap-skills

使用 npm run bootstrap-skills -- --force 以覆盖存根。然后让代理将MCP索引增量合并到每个增量中 SKILL.md.

• 或者跳过引导 并依靠代理人：之后 get_rabbit_sdk_knowledge_index，代理人可以 创造 ~/.cursor/skills/rabbit-creations-official/SKILL.md 和 r1-create-community/SKILL.md 从MCP有效载荷(officialCreationsSdk, r1Create, skillGuidance).当文件丢失时，MCP响应告诉它这样做。

安装

macOS/Linux

cd rabbit-ideas-mcp
chmod +x install.sh
./install.sh

Windows（PowerShell）

cd rabbit-ideas-mcp
npm install

可选：使用 install.ps1 如果您依赖于Windows启动快捷方式工作流（Cursor仍然通过以下方式生成服务器 mcp.json).

光标MCP配置

增添 ~/.cursor/mcp.json （macOS/Linux）或 %USERPROFILE%\.cursor\mcp.json （Windows）。使用 绝对路径 到 index.js 在您的机器上：

{
  "mcpServers": {
    "rabbit-r1-ideas": {
      "command": "node",
      "args": ["/absolute/path/to/rabbit-ideas-mcp/index.js"]
    }
  }
}

工具

文档库流程

1. register_documentation_source （或 pull_documentation_library_from_github 在别人发表之后）。
2. get_rabbit_sdk_knowledge_index --一个有效载荷包括官方SDK， r1-create，以及所有已注册的URL。
3. discover_missing_local_skills → ensure_local_skill_for_registered_source 对于每一个新 skillSlug 所以Cursor加载了个人技能。
4. 可选地 publish_documentation_library_to_github 同步 library/ 上 拉比-r1-sdk-idea-helper-mcp 对于其他人来说 pull.

个人技能（不在此仓库中）

SDK知识应该存在 个人的 游标技能，使其不致力于应用程序代码库：

• ~/.cursor/skills/rabbit-creations-official/SKILL.md --Creations SDK/GitHub官方工作流程。
• ~/.cursor/skills/r1-create-community/SKILL.md --npm r1-create API和模式。
• ~/.cursor/skills/{skillSlug}/SKILL.md --每个文件夹一个 register_documentation_source 条目（来自名称或 skillSlug).

创建这些文件： 使用 npm run bootstrap-skills 一次， 或 依赖代理从 get_rabbit_sdk_knowledge_index 有效载荷，当它们还不存在时。

打电话后 get_rabbit_sdk_knowledge_index，代理人应该 仅合并新事实 在这些文件中（附加/注明日期的变更日志）。每项技能都应该明确说明： 不进行网络搜索 当技能+MCP已经涵盖SDK API细节时；请改用此工具刷新。

请参阅中的Cursor技能布局 在游标中创建技能 （个人技能与项目技能）。

环境

资源

• rabbit://ideas/storage --完整的JSON存储。
• rabbit://ideas/stats --计数和缓存时间戳。
• rabbit://sdk/knowledge-index --最后缓存的统一索引（如果有的话）。
• rabbit://documentation/library --注册文档源+默认库仓库URL。

常见问题解答

这个MCP是做什么的？

要求是什么？

Node.js 18+ （全球 fetch).此服务器不需要API密钥；它只调用公共GitHub和npm/unpkg端点。

如何将其添加到Cursor？

输入条目 ~/.cursor/mcp.json （macOS/Linux）或 %USERPROFILE%\.cursor\mcp.json （Windows）带 "command": "node" 和 args 设置为 绝对路径 到 rabbit-ideas-mcp/index.js。JSON字符串中带空格的路径很好。 重新启动游标 更改后（或重新加载MCP） mcp.json.

如果我把仓库放在GitHub上，它对其他人有效吗？

对。他们克隆、奔跑 npm install 在 rabbit-ideas-mcp，和点 他们的 mcp.json 在 他们的 机器的路径 index.js. mcp.json, rabbit-ideas-storage.json，以及 ~/.cursor/skills/... 是按用户分配的，不由仓库单独共享（存储是gitignored）。

为什么两个SDK（官方vs r1-create)?

官方 creations-sdk 是规范的GitHub仓库（插件演示、QR流、简短的README）。 r1-create 是一个 社区 具有更丰富的TS/API表面（硬件、LLM助手、UI等）的npm包。索引工具返回 两者 加 recommendation 提示；代理人仍在跟进 你的 任务和技能。

代理应该首先调用哪个工具来进行SDK工作？

get_rabbit_sdk_knowledge_index.使用 refreshCache: true 当你想绕过服务器端缓存并重新缓存所有内容时。使用 maxReadmeChars 如果您需要有效负载中更长或更短的README摘录。

数据存储在哪里？

服务器旁边： rabbit-ideas-mcp/rabbit-ideas-storage.json --建议的想法、可选的回购快照，以及 sdkIndexCache 对于统一指数。该文件是 被忽视 因此，个人想法和缓存不会推送到GitHub。

SDK索引缓存多长时间？

默认 24小时 (86400000 ms）。用env覆盖 RABBIT_MCP_SDK_CACHE_TTL_MS （毫秒）。

为什么要提升个人技能(npm run bootstrap-skills)?

所以 ~/.cursor/skills/rabbit-creations-official/SKILL.md 和 r1-create-community/SKILL.md 在第一次运行之前存在。这避免了代理人从中发明模式 无关的 打开的项目（例如工作区中的另一个Creations应用程序）。 npm run bootstrap-skills -- --force 覆盖这些存根；之后从新的MCP索引中重新合并所需的任何内容。

我可以跳过引导吗？

对。之后 get_rabbit_sdk_knowledge_index，代理人可以 创造 有效载荷中的两个技能文件(skillGuidance，README字段）。Bootstrap只是可重复的、克隆友好的快捷方式。

SDK技能是否存在于这个git仓库中？

号码 把它们放在下面 ~/.cursor/skills/ （个人技能）。此回购仅发货 bootstrap-skills.mjs 以在本地生成相同的存根。

为什么必须用 save_generated_ideas?

因此，服务器可以强制执行 不再重犯 跨届会议。模型生成想法后，它应该调用 save_generated_ideas 与阵列。 clear_idea_history 和 confirm: true 重置列表。

是什么 sdkTarget 上 generate_rabbit_creation_ideas?

auto （默认）， official_creations_sdk, r1_create，或 both --引导 提示文本 在工具返回的上下文中；它不会单独切换该工具调用哪些远程服务器（完全双SDK拉取 get_rabbit_sdk_knowledge_index).

MCP工具未显示在光标中

确认 mcp.json 语法，即 node 在终端中运行 index.js 路径是正确的。 重新启动游标 完全地在Windows上，使用完整路径 node.exe 在 "command" 仅当Cursor的环境看不到时 node 上 PATH.

GitHub返回很少或没有README文本

官方 创作sdk README可以是 短的 通过设计；服务器仍然返回 文件树 和 提交.长期API文档使用 r1-create的README文件位于同一索引有效负载中。未经身份验证的GitHub可能会受到攻击 费率限制；如果发生这种情况，请稍后重试或减少来自同一IP的并行流量。

是 r1-create 兔官？

号码 它是一个 社区 npm包(, Boondit概述).仅此MCP 公开阅读 包元数据和README文本；它不认可或捆绑该SDK。

怎么样 npm audit 报告漏洞？

它们通常来自 @modelcontextprotocol/sdk 或传递依赖关系。修复可能需要一个重大的SDK升级；将其视为正常的节点依赖卫生，而不是特定于Rabbit产品逻辑。

文档库+GitHub同步是如何工作的？

你 注册 http（s）URL register_documentation_source。它们存储在本地 并行提取 当您调用时，使用这两个SDK get_rabbit_sdk_knowledge_index。要创建光标技能，请使用 discover_missing_local_skills 和 ensure_local_skill_for_registered_source.

更新 Tourettes99/r1-sdk-idea-helper-mcp，set RABBIT_MCP_GITHUB_TOKEN （或 GITHUB_TOKEN)有权推送到该仓库，然后使用 publish_documentation_library_to_github 或 autoPublishToGithub: true 在登记册上。MCP写入 library/skills/{skillSlug}/SKILL.md 和 library/documentation-sources.json.其他人可以跑 pull_documentation_library_from_github 导入新的清单条目。

HTML页面通过简单的条带（而不是完整的浏览器）转换为纯文本；如果可能的话，更喜欢原始Markdown或纯文本URL。

为什么我的GitHub发布失败了？

常见原因：令牌丢失或过期，令牌无 回购内容 范围，推送到您不拥有的仓库（无权限分叉），或分支不 main 用于原始清单URL。服务器使用 main 为了 pull_documentation_library_from_github.

许可证

麻省理工学院——见 许可证.

r1-create 是一个独立的项目（npm上的Apache-2.0）；此MCP仅获取公共元数据和README文本。