使用说明
兔子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"]
}
}
}
工具
| 工具 | 目的 |
|---|---|
get_rabbit_sdk_knowledge_index |
先叫这个 用于SDK+文档上下文。并行获取：官方GitHub+ r1-create + 每个已注册的文档URL.退货 registeredDocumentation、比较、关键字索引， skillGuidance.可选： refreshCache, maxReadmeChars. |
register_documentation_source |
添加 name + url （http）。可选的 skillSlug；可选 autoPublishToGithub （需要令牌）。存储在 rabbit-ideas-storage.json；包含在下一个索引中。 |
list_documentation_sources |
列出已注册的库条目。 |
remove_documentation_source |
删除方式 id (confirm: true). |
discover_missing_local_skills |
将库与进行比较 ~/.cursor/skills/{skillSlug}/SKILL.md. |
ensure_local_skill_for_registered_source |
获取URL并写入/更新本地 SKILL.md 首先 sourceId. |
publish_documentation_library_to_github |
推 library/skills/{slug}/SKILL.md 每个（或一个 sourceId) + library/documentation-sources.json 到 库仓库。需要 RABBIT_MCP_GITHUB_TOKEN 或 GITHUB_TOKEN. |
pull_documentation_library_from_github |
将回购清单中的新条目合并到本地存储中（不删除仅限本地的源）。 |
generate_rabbit_creation_ideas |
20个想法的背景；可选的 sdkTarget: auto |
get_previous_ideas |
列出/搜索存储的想法。 |
iterate_on_idea |
按索引迭代存储的想法。 |
get_repo_status |
仅限GitHub官方仓库快照。 |
save_generated_ideas |
坚持产生的想法。 |
clear_idea_history |
重置存储的想法(confirm: true). |
文档库流程
register_documentation_source（或pull_documentation_library_from_github在别人发表之后）。get_rabbit_sdk_knowledge_index--一个有效载荷包括官方SDK，r1-create，以及所有已注册的URL。discover_missing_local_skills→ensure_local_skill_for_registered_source对于每一个新skillSlug所以Cursor加载了个人技能。- 可选地
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--npmr1-createAPI和模式。~/.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_MCP_SDK_CACHE_TTL_MS |
中缓存的统一索引的TTL rabbit-ideas-storage.json （默认值 86400000 ms）。 |
RABBIT_MCP_GITHUB_TOKEN 或 GITHUB_TOKEN |
细粒或经典PAT 和 内容：读写 上 Tourettes99/r1-sdk-idea-helper-mcp （或您的覆盖仓库）。用于 publish_* 和 autoPublishToGithub。永远不要承诺代币。 |
RABBIT_MCP_LIBRARY_REPO |
可选 owner/repo 覆盖发布（默认 Tourettes99/rabbit-r1-sdk-idea-helper-mcp). |
资源
rabbit://ideas/storage--完整的JSON存储。rabbit://ideas/stats--计数和缓存时间戳。rabbit://sdk/knowledge-index--最后缓存的统一索引（如果有的话）。rabbit://documentation/library--注册文档源+默认库仓库URL。
常见问题解答
这个MCP是做什么的？
它作为一个 标准 Cursor中的MCP服务器（以及类似的客户端）。它（1）有助于生成和 记住 兔子R1 创作 应用程序创意使用来自 官方的 创作sdk repo，以及（2）暴露 get_rabbit_sdk_knowledge_index，拉动 官方GitHub+npm r1-create +已注册文档URL 在 一 调用，这样代理就不需要很多单独的查找。可选工具发布不断增长的 library/ 上 拉比-r1-sdk-idea-helper-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包(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文本。