Claude代码的警告插件
通过Caves Oracle MCP服务器将Caves知识图与Claude Code集成。
特性
- 🔗 连接概念并构建知识图
- 📚 将烹饪书索引转换为可导航结构
- 🔍 搜索并浏览您的洞穴视角
- 🎯 烹饪书处理的自动技能调用
- ☁️ 基于云的MCP服务器（无需本地安装）
先决条件
- Caves帐户（注册地址：https://itscaves.com)
安装
快速安装（推荐）
# Add the ic-caves marketplace
/plugin marketplace add ic-caves/caves-claude-plugin
# Install the plugin
/plugin install caves@ic-caves-caves-claude-plugin手动安装
# Clone the repository
git clone https://github.com/ic-caves/caves-claude-plugin.git
# Add as a local marketplace
/plugin marketplace add ./caves-claude-plugin
# Install the plugin
/plugin install caves@caves-claude-plugin验证
检查插件是否已成功加载：
/plugin
# Look for "caves" in the Installed tab通过洞穴进行身份验证
首次使用时，Claude Code会提示您进行身份验证：
- 浏览器窗口将打开itscaves.com
- 使用您的Caves帐户登录
- 授权Claude Code访问您的洞穴数据
- 返回克劳德代码-身份验证完成！
验证
测试安装：
# In Claude Code, try:
"Show me my Caves perspectives"你应该看到你的观点被列出。
技能包括
洞穴知识
洞穴知识中心-通过搜索文档、博客和洞穴系统来回答问题。
用途：
- 询问有关洞穴概念的问题：“洞穴中的火是什么？”
- 获取功能解释：“透视图是如何工作的？”
- 查找文档：“如何添加内容？”
- 该技能搜索本地文档、博客，并可以使用MCP工具进行实时示例
洞穴食谱索引
自动将烹饪书索引页面转换为洞穴知识图连接。
用途：
- 上传烹饪书索引图片
- 提及“转换为洞穴”或“在洞穴中组织食谱索引”
- 该技能将指导您完成整个过程
代理注册
通过电子邮件验证指导Claude代理商完成Caves帐户注册。
用途：
- 说“我需要创建一个洞穴帐户”
- 说“注册洞穴”或“代理注册”
- 该技能将指导您完成3个步骤：
1. 收集电子邮件和用户名信息 1. 提交注册并发送验证电子邮件 1. 轮询以进行人工验证和检索凭据
- 重要：API密钥只显示一次-安全保存！
api参考
为Caves提供完整的HTTP API参考，包括身份验证、端点和curl示例。
用途：
- 说“给我看洞穴API文档”
- 说“我如何向洞穴发出HTTP请求”
- 说“API参考”或“卷曲示例”
- 为MCP工具提供API直接访问替代方案
- 包括身份验证、所有端点、请求/响应示例
- 在Claude Code之外构建自定义集成或脚本时使用
MCP工具可用
Caves Oracle MCP服务器提供以下工具：
caves__search_caves-按查询搜索标签/洞穴caves__my_shadows-通过描述获得你的观点（PID）caves__connect_caves-在洞穴/标签之间创建连接caves__disconnect_caves-拆除洞穴之间的连接caves__get_subcaves-把孩子洞穴换成父母洞穴caves__my_shadow_caves-获取完整的透视图caves__getPidsForTags-查找已连接到特定标签的PIDcaves__getPidsForConnection-查找在连接上同意/不同意的PIDcaves__createPerspective-使用用户名创建新视角caves__read_ipfs-从洞穴中读取IPFS内容（图像/文本）
配置
认证
无需手动配置！该插件使用OAuth进行身份验证：
- 首次使用提示基于浏览器的登录
- 由Claude Code安全存储的凭据
- 仅当令牌过期时才需要重新身份验证
洞穴URL架构
通过URL直接访问洞穴：
https://itscaves.com/c/{url-encoded-cave-name}示例：
- https://itscaves.com/c/smoke%20and%20pickles
- https://itscaves.com/c/edward%20lee
- https://itscaves.com/c/kimchi
故障排除
“未找到caves-mcp-mcp服务器”
- 重新启动Claude Code以加载插件
- 检查插件是否安装在
~/.claude/plugins/caves - 验证
.mcp.json文件存在于插件目录中
“身份验证失败”或“需要登录”
- 当出现身份验证提示时，单击它
- 在浏览器中完成OAuth流程
- 如果浏览器未打开，请检查弹出窗口阻止程序
- 尝试在itscaves.com上注销并重新登录
“连接超时”
- 检查您的互联网连接
- 验证https://oracle.itscaves.com可访问的
- 请稍后重试（服务器可能正在更新）
用法示例
查看您的观点
"Show me all my Caves perspectives"寻找洞穴
"Search Caves for 'recipe' tags"创建连接
"Connect 'kimchi' to 'fermented foods' in my Caves perspective"转换食谱索引
[Upload cookbook index images]
"Convert this cookbook index to Caves using my 'cookbooks' perspective"文档
- 洞穴网站：https://itscaves.com
- 不和谐社区：https://discord.com/invite/8bW2xwv7kc
- MCP服务器：https://oracle.itscaves.com/sse
- 洞穴文件: https://github.com/ic-caves/caves-docs-洞穴知识图系统的技术文件和指南
- .ic文件格式: https://github.com/ic-caves/ic-docs.ic文件格式的文档（底层数据结构）
许可证
麻省理工学院
贡献
欢迎在https://github.com/ic-caves/caves-claude-plugin