Caves Claude Plugin

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会提示您进行身份验证：

1. 浏览器窗口将打开itscaves.com
2. 使用您的Caves帐户登录
3. 授权Claude Code访问您的洞穴数据
4. 返回克劳德代码-身份验证完成！

验证

测试安装：

# 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 -查找已连接到特定标签的PID
• caves__getPidsForConnection -查找在连接上同意/不同意的PID
• caves__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