MCP 集成

Hebb Mind 提供 MCP (Model Context Protocol) 服务，将记忆操作暴露为工具。Claude Code、Codex、Cursor 等 MCP 客户端可以直接使用。

前提条件

Hebb Mind 统一以操作系统后台服务运行（macOS launchd / Linux systemd / Windows 任务计划程序）。MCP 服务启动时若发现后台服务未运行，会自动请求 OS 服务管理器拉起：

hebb setup              # 首次使用 — 选择模型和镜像源
hebb service install    # 注册后台服务（默认用户级，无需管理员权限）

可用工具

工具	描述	参数
write_memory	写入记忆到海马体工作区	content, tags?, importance?
search_memory	混合检索（向量+关键词+图谱）	query, top_k?
consolidate	触发记忆巩固	无

配置

MCP 服务自动从 hebb.json 发现服务地址。大多数情况下无需任何配置，只需添加命令即可。

如果服务运行在远程主机或非默认地址，可通过 HEBB_URL 环境变量指定：

Claude Code

推荐：

hebb claude-code install --scope user

仅 MCP：

在项目目录下创建 .mcp.json：

{
  "mcpServers": {
    "hebb": {
      "command": "hebb-mcp"
    }
  }
}

或在全局配置 ~/.claude.json 中添加相同内容。

如果服务运行在非默认地址，可以显式指定：

{
  "mcpServers": {
    "hebb": {
      "command": "hebb-mcp",
      "env": {
        "HEBB_URL": "http://192.168.1.100:8321"
      }
    }
  }
}

Codex

推荐：

hebb codex install --scope user
codex mcp list

Codex 原生命令：

codex mcp add hebb -- hebb-mcp

Claude Desktop

在 claude_desktop_config.json（macOS 通常位于 ~/Library/Application Support/Claude/claude_desktop_config.json）中添加：

{
  "mcpServers": {
    "hebb": {
      "command": "hebb-mcp"
    }
  }
}

Cursor

打开 Settings → Features → MCP，添加：

{
  "mcpServers": {
    "hebb": {
      "command": "hebb-mcp"
    }
  }
}

工作原理

Claude Code / Codex / Cursor
        │ (stdio)
        v
  hebb-mcp (MCP 服务)
        │ (HTTP 调用)
        v
  hebb _serve (REST API, 端口 8321, 由 OS 服务管理器拉起)
        │
  存储 / Embedding / 检索

MCP 服务是一个薄包装层，将 MCP 工具调用转换为对运行中 Hebb Mind 服务的 HTTP 请求。所有存储、向量和检索逻辑都在主服务中。

CLI 使用

也可以直接启动 MCP 服务：

hebb mcp serve

以 stdio 模式运行，适合与 MCP 客户端直接集成。

使用示例

配置完成后，AI 助手可以：

1. 存储上下文：「记住用户偏好 TypeScript 而不是 JavaScript」
2. 后续召回：「用户的语言偏好是什么？」
3. 整理记忆：触发巩固，将记忆分类到对应分区