AI导哈

Claude技能服务器

连接Claude Desktop到自托管Carabase实例的MCP服务器，提供6种检索工具和15种主机域工具，用于管理日常笔记、任务、知识图谱等。

  • by carabase
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 carabase/carabase-claude-skills

使用说明

卡拉巴斯·克劳德技能

一 主控程序 连接的服务器 克劳德桌面版 到你自己主持 卡拉贝斯 例子 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/<id> 资源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/<id> 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_HOST URL可访问： curl http://localhost:3000/health

工具工作，但返回空结果

  • 您的工作区可能还没有数据——请先在Carabase桌面应用程序中创建一些日常笔记

相关

许可证

麻省理工学院

相关 MCP