Caigen Notes

AI-native note-taking (菜根笔记) with RAG semantic search over your notes. Connect Claude/Cursor to search, read, write and share your notes.

View on gobiji.cn

Documentation

用 AI 客户端直连你的菜根笔记

菜根笔记 MCP Server 让 AI 客户端直接读写你的笔记——AI 原生笔记 + RAG 语义检索。

https://b.gobiji.cn/mcp

远程 MCP 服务

MCP Streamable HTTP（协议版本 2025-03-26），HTTPS POST /mcp，本地不用跑任何进程

12 个工具

笔记读写、语义检索、标签管理、配额统计，覆盖笔记全生命周期

个人 API Key 鉴权

Bearer Token 鉴权，按账号隔离数据，客户端只能访问你自己的笔记

HTTPS 加密传输

公网地址全链路加密，密钥只留在你自己的客户端配置文件里

服务地址与协议

服务地址

https://b.gobiji.cn/mcp

协议

MCP Streamable HTTP（协议版本 2025-03-26）

传输

HTTPS，POST /mcp

认证

Authorization: Bearer <API Key> （也支持 X-Api-Key: <API Key> 头）

未带 Key 时返回 401：

{"error":"Unauthorized","message":"Bearer token or API key required"}

12 个工具

连接成功后客户端会看到下面这 12 个工具，覆盖笔记的读、写、检索、标签与配额。

工具	说明
`list_notes`	按页翻最近的笔记
`get_note`	看某条笔记全文
`search_notes`	找笔记（支持 keyword 精确词与 semantic 语义/向量检索）
`create_note`	记一条笔记
`update_note`	改笔记内容或状态（置顶/归档）
`delete_note`	移到回收站（软删除，可恢复）
`restore_note`	从回收站恢复
`add_tags`	给笔记贴标签
`remove_tags`	去掉标签
`share_note`	生成分享链接
`list_tags`	列出所有标签
`get_quota`	查看笔记/标签/活跃天数统计

获取 API Key

1打开 API Key 设置页（https://b.gobiji.cn/settings?tab=api-key）
2点「API Key」设置项 → 「新建」，填一个名字（例如 MCP 接入 ）→ 确认
3在弹窗里复制明文 Key，粘贴到下面任意一种客户端配置中

明文 Key 只显示一次

创建后立刻复制保存，关闭弹窗后无法再查看。
列表里只显示前缀（形如 cg_live_xxxxxxxx ），明文永不回显。
Key 形如 cg_live_ + 32 位十六进制，共 40 字符。
泄漏了怎么办：到同一个面板「吊销」该 Key，再新建一个新的。

客户端配置

Claude Desktop

配置文件位置：macOS ~/Library/Application Support/Claude/claude_desktop_config.json ，Windows %APPDATA%\Claude\claude_desktop_config.json
打开方式：菜单栏 Claude → Settings… → Developer → Edit Config
Claude Desktop 的 claude_desktop_config.json 只认本地 stdio server，没有远程 URL 字段，所以远程 MCP 要通过 mcp-remote 桥接（npm 包 mcp-remote ）

{
  "mcpServers": {
    "caigen": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://b.gobiji.cn/mcp",
        "--header",
        "Authorization:${CAIGEN_API_KEY}"
      ],
      "env": {
        "CAIGEN_API_KEY": "Bearer cg_live_你的密钥"
      }
    }
  }
}

保存后必须 完全退出并重启 Claude Desktop ，重启后输入框右下角出现锤子（hammer）图标表示连接成功
日志： ~/Library/Logs/Claude/mcp*.log

Cursor

配置文件： ~/.cursor/mcp.json
Cursor 原生支持远程 URL + 自定义头，直接写：

{
  "mcpServers": {
    "caigen": {
      "url": "https://b.gobiji.cn/mcp",
      "headers": {
        "Authorization": "Bearer cg_live_你的密钥"
      }
    }
  }
}

保存后在 Cursor 的 Settings → MCP 里能看到 caigen 与它的 12 个工具
用 /mcp 命令可查看状态

Hermes

方式一（CLI 交互式）：

hermes mcp add caigen --url https://b.gobiji.cn/mcp --auth header

命令会提示「Does this server require authentication?」选 Y，然后粘贴 API Key（不带 Bearer 前缀）
Key 会被存进 profile 的 .env ， config.yaml 里只留 Authorization: Bearer ${MCP_CAIGEN_API_KEY} 模板

方式二（直接写 ~/.hermes/config.yaml ，本仓用 profile 时是 ~/.hermes/profiles/<profile>/config.yaml ）：

mcp_servers:
  caigen:
    url: https://b.gobiji.cn/mcp
    headers:
      Authorization: Bearer ${MCP_CAIGEN_API_KEY}
    enabled: true

并在同 profile 的 .env 里加一行：

MCP_CAIGEN_API_KEY=cg_live_你的密钥

验证： hermes mcp test caigen → 应输出 ✓ Connected 与 ✓ Tools discovered: 12
会话内用 /reload-mcp 重新加载

验证是否接通了

在终端里跑一次初始化握手：

curl -s -X POST https://b.gobiji.cn/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer cg_live_你的密钥" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"probe","version":"1.0"}}}'

期望：HTTP 200，响应头里有 mcp-session-id
body 是 event: message + data: {...} ，其中 serverInfo.name 为 caigen

常见问题 / 排错

401 Unauthorized

Key 不对、已被吊销，或前后带了多余空格。确认请求头是 Authorization: Bearer <Key> （ Bearer 后面有一个空格）；也可以把不带 Bearer 前缀的 Key 直接塞进 X-Api-Key 头。

Claude Desktop 连不上

多半是没完全重启（改完配置必须完全退出并重开 Claude Desktop）；其次是 npx 不通，国内网络建议先执行 npm config set registry https://registry.npmmirror.com ；如果怀疑 mcp-remote 没装成功，可以先手动跑一次 npx -y mcp-remote https://b.gobiji.cn/mcp 看报错信息。

连接超时 / 连不上服务器

b.gobiji.cn 是公网 HTTPS 地址，客户端所在网络必须能出网。企业内网、代理或防火墙环境需要放行该地址，否则表现为连接超时。

工具列表为空 / 看不到 12 个工具

多半是客户端还连着旧的 localhost 地址。确认 URL 是 https://b.gobiji.cn/mcp ，改完配置后重新加载客户端。

调用报权限错误

MCP 工具以你本人身份执行，操作的就是你自己的笔记。Key 属于哪个账号，看到和能改的就是哪个账号的数据，不存在跨账号访问。

吊销 Key 后客户端失效

这是预期行为。回到设置页新建一个新的 Key，再把客户端配置里的旧 Key 换掉即可。

安全说明

Key 等同于你账号的操作权限：拿到 Key 的人就能读写你的笔记。请勿把 Key 提交到代码仓库或公开分享，吊销后立即失效。

能力边界

目前是「纯工具集」形态：只提供 12 个笔记 / 标签 / 配额工具，不涉及对话历史、AI 会话等内容。这与菜根笔记「AI 原生笔记」的定位一致——AI 通过语义检索读你的笔记，而不是把对话历史搬进笔记。

MCP 服务地址与工具清单会随版本更新，以本页为准。