卡拉巴斯·克劳德技能
一 主控程序 连接的服务器 克劳德桌面版 到你自己主持 卡拉贝斯 例子 6个规范检索工具+15个主机域工具 用于管理日常笔记、任务、知识图、对开本、工件和记忆——所有这些都可以通过克劳德的聊天界面进行。
v0.2.0的新增功能
- 规范的
carabase_*检索表面。 六种检索工具(carabase_search_semantic,carabase_search_graph,carabase_query_metadata,carabase_find_entity_candidates,carabase_route_and_execute,carabase_verify_hypothesis)现在是主机的薄传递@carabase/mcp-server包裹。评分、提示修复、压缩和FLARE验证都在主机上实时进行——请参阅 甲壳动物宿主CLAUDE.md 对于整个表面。 - 拉格医生暗示预告片。 规范工具的空状态和错误响应包括
[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.克隆和构建```bash
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```bash
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:```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` (例如添加工具):```bash
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代理技能模板
许可证
麻省理工学院
