卡拉巴斯·克劳德技能
v0.2.0的新增功能
- 拉格医生暗示预告片。 规范工具的空状态和错误响应包括
[hint: …]和[trace: …]拖车。这些在往返途中幸存下来-- 不要从代理输出中过滤它们；它们的存在使得代理可以在不重新规划的情况下进行自我纠正。 - 懒惰的工件资源。 工具结果现在返回
carabase://artifact/资源URI，而不是内联主体。克劳德通过以下方式按需阅读resources/read（注册为carabase-artifact资源模板）。 carabase_verify_hypothesis（第15阶段）。 FLARE风格的索赔检查与判决corroborated/contradicted/mixed/inconclusive加上支持/反驳的证据块。- 弃用的别名。
search_semantic和query_graph仍然有效，但标记为“已弃用”并转发到规范工具。它们将在v0.3.0中删除。
先决条件
- Node.js 22+
- 跑步 卡拉贝斯主机 例子甲壳动物宿主)
- 克劳德桌面版 安装
快速开始
1.克隆和构建
git clone https://github.com/carabase/carabase-claude-skills.git
cd carabase-claude-skills
npm install
npm run build这产生 dist/claude-mcp.cjs --Claude Desktop将生成的MCP服务器。
2.查找您的工作区ID
psql postgresql://localhost:5432/carabase -c "SELECT id FROM workspaces LIMIT 1;" -t复制UUID（例如。 42b815b2-bd1b-4e35-82a7-fd1d3b111ece).
3.配置克劳德桌面
编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"carabase": {
"command": "node",
"args": ["/ABSOLUTE/PATH/TO/carabase-claude-skills/dist/claude-mcp.cjs"],
"env": {
"CARABASE_HOST": "http://localhost:3000",
"CARABASE_WORKSPACE_ID": "YOUR-WORKSPACE-UUID"
}
}
}
}替换 /ABSOLUTE/PATH/TO/ 带有克隆此仓库的实际路径。
4.重新启动克劳德桌面
退出并重新打开Claude Desktop。点击 插头图标 在聊天输入中，您应该看到“carabase”列出了所有可用的工具。
可用工具
规范检索（转发到主机 @carabase/mcp-server)
| 工具 | 说明 |
|---|---|
carabase_search_semantic | 矢量相似性搜索；回报 carabase://artifact/ URI |
carabase_search_graph | 实体查找，可选 depth (1–3) |
carabase_query_metadata | 按标签/日期/来源/实体筛选搜索 |
carabase_find_entity_candidates | 多策略实体名称解析器 |
carabase_route_and_execute | 第一阶段路由器——NL查询的自动选择策略 |
carabase_verify_hypothesis | FLARE风格的索赔验证与判决+证据 |
遗产 search_semantic 和 query_graph 保持为 已弃用 别名，将在v0.3.0中删除。
主机域工具
| 工具 | 类别 | 描述 |
|---|---|---|
list_entities | 知识图谱 | 按类型浏览实体 |
list_folios | Folios | 浏览项目集合 |
read_folio_map | 对开本 | 获取对开本背景和时间线 |
commit_to_folio | 对开本 | 附加到对开本的时间线 |
update_folio_section | 对开本 | 修改对开本元数据 |
read_daily_note | 每日笔记 | 阅读一天的笔记作为标记 |
create_log_entry | 每日笔记 | 写一个带时间戳的日志条目 |
create_task | 任务 | 在每日笔记中创建任务 |
list_tasks | 任务 | 列出和筛选任务 |
toggle_task | 任务 | 选中/取消选中任务 |
read_artifact | 工件 | 读取上传的文件内容 |
search_memories | 回忆 | 搜索提炼的见解 |
create_memory | 记忆 | 存储新的记忆/见解 |
看 docs/mcp-tools.md 详细工具参考示例。
配置
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
CARABASE_HOST | 没有 | http://localhost:3000 | Carabase主机的基本URL |
CARABASE_WORKSPACE_ID | 是 | -- | 要操作的工作区的UUID |
CARABASE_API_KEY | 没有 | - | neneneba API密钥（如果在主机上启用了身份验证） |
将这些设置在 env Claude Desktop配置的块（请参阅上面的快速入门）。
变更后的重建
如果你修改 src/claude-mcp.ts （例如添加工具）：
npm run build然后重新启动Claude Desktop以获取新服务器。
故障排除
“carabase”未出现在Claude Desktop的工具列表中
- 检查路径
claude_desktop_config.json绝对正确 - 确保
dist/claude-mcp.cjs存在（运行npm run build) - 重新启动Claude Desktop（完全退出，然后重新打开）
工具返回有关工作区ID的错误
- 验证
CARABASE_WORKSPACE_ID已设置并且是有效的UUID - 运行上面的psql命令以确认它与您的数据库匹配
工具返回连接错误
- 确保Carabase主机正在运行(
cd carabase-host && pnpm dev) - 验证
CARABASE_HOSTURL可访问：curl http://localhost:3000/health
工具工作，但返回空结果
- 您的工作区可能还没有数据——请先在Carabase桌面应用程序中创建一些日常笔记
相关
- 甲壳动物宿主 --自托管后端
- carabase桌面 --本机macOS客户端
- 甲壳爪技能 --OpenClaw代理技能模板
许可证
麻省理工学院