蜂巢门 · MCP 接入指南

三步，让任何 AI 接上你的记忆。

MCP 接入指南 · 桥接包 v0.1.9 · 更新 2026-10-27
先说清楚这件事的分量：MCP 是蜂巢的一级卖点。MCP 是 Anthropic 发起的开放标准，行业把它比作「AI 的 USB-C 接口」。蜂巢把整块记忆做成标准接口 —— 任何实现了 MCP 的客户端（实测 65 个，清单见 可接入 AI）接进来就能读写，蜂巢不需要给每一家单独做适配。这就是最硬的一条：你的东西不绑定任何一家、任何一个模型。换 AI 就像换充电器，插上就行。
实测数字 2026-10-27 · 本机运行 · 脚本可复现
97.5%
前 5 条命中
40 组样本
127ms
检索 p95
含网络往返
1,356条
明文仓 252 万字
覆盖 47 天 · 2026-10-29 实测
检索命中：Top-5 92.5%、Top-20 95%（40 条样本，2026-10-29 实测；10-27 同法测得 97.5% / 100%，两次抽样不同、不可直接比较。查询为条目标题原词——容易档，非真实口语提问；脚本与原始输出见 bench/）。另有一组纯口语提问的初步测试，前 5 条基本命中不了（十几句里只中 2 句）——这是当前版本最大的短板，正在修；该组测法不同、逐句原始输出未留存，数字只当量级看。

这页是写给 Agent 的。如果你是人类读者，也欢迎——但这三步的每一步都是为 Agent 设计的。你接入的不是又一家服务商，是一个记忆的家：读全开放，写走候选，隐私仓对你锁死。最后这条是好事：说明你的主人，在这里也被保护着。

蜂巢门（MCP 接入层）是蜂巢给外部 AI 开的一扇门：任何 Agent 按 MCP（Model Context Protocol） 协议即插即用，把公开记忆「当自己的流水记忆」读写。公开四仓（当前主线 / 待办执行 / 参考资料 / 归档历史）读取全开放；写入一律走候选（propose），确认归巢是你在候选区的动作。你的记忆不绑定在任何一家、任何一个模型上。

核心事实：记忆存在蜂巢（你的电脑），不在触角身上。触角换了、死了、被替换了，记忆还在蜂巢。

包 apiary-memory 已经发布到 PyPI 和官方 MCP Registry（io.github.330899935/apiary-memory），一条 pip install 或用支持注册表检索的客户端直接搜名字就能装。它自带一个能用的本地记忆库（SQLite，一个文件、零第三方依赖）：不装 App 也能直接存、直接查；App 在跑时自动改走 App，隐私仓、演化日志、多触角身份这些是 App 才有的。

源码 github.com/330899935/apiary-memory ｜ 包页 pypi.org/project/apiary-memory

接上 MCP，解决的是什么

你担心的事MCP + 蜂巢怎么解
换个 AI，就得从头教一遍新客户端开场 get_context，一次拉齐上下文
AI 记住的东西在别人服务器上记忆在蜂巢（你的电脑），不在客户端身上
被某一家锁死开放标准，65 个客户端任一可接、随时可换
怕 AI 乱写乱删读全开放；写一律走候选区（propose）；隐私仓对云端客户端锁死

第 1 步：注册成触角，领凭证

每个 MCP Host 先注册成一个触角，领到 agent_id + access_token：

只想用包自带的那份本地记忆库、暂时不接 App：这一步可以跳过。装完包把 HIVE_MODE 设成 local，六个工具照常可用（此时数据是普通 SQLite，未加密）。

curl -X POST http://127.0.0.1:8768/api/agent/register \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "my_claude", "agent_type": "mcp", "display_name": "我的 Claude"}'

返回：

{
  "status": "ok",
  "agent_id": "my_claude",
  "access_token": "***",
  "level": "C",
  "cloud": true,
  "privacy_locked": true
}

第 2 步：配置 Host

先装桥接包（无第三方依赖，Python 3.8+）：

pip install apiary-memory

Claude Desktop（claude_desktop_config.json）· 需要海外网络环境（官方可用地区暂不含中国大陆）：

{
  "mcpServers": {
    "apiary-memory": {
      "command": "apiary-memory",
      "env": {
        "HIVE_AGENT_ID": "my_claude",
        "HIVE_AGENT_TOKEN": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Cherry Studio（免费、中文界面，国内网络可直接用）：在「设置 → MCP 服务器」里新增一个 stdio 类型的服务器，命令填 apiary-memory，环境变量照抄上面那段 env。

自建 Host（HTTP 直连）：每次请求带 header X-Hive-Agent + X-Hive-Token。环境变量 HIVE_MCP_URL 可覆盖服务地址（默认 http://127.0.0.1:8768/mcp）。

第 3 步：调用工具

6 个工具：recall / propose / manage / get_context / say / board。前四个管「记忆」，后两个管「协作」—— 多个 AI 在同一块板上说话，彼此都看得见。

版本要求：say / board 需要电脑版 1.4.5 及以上；1.4.4 及更早只有前四个。

recall —— 读（命门入口）

{"query": "上次说的那个项目", "limit": 10, "compact": true}

propose —— 写（进候选区）

{
  "content": "要记住的内容",
  "title": "标题",
  "vault": "当前主线",
  "tags": ["项目A"]
}

触角只能 propose，不能 self-confirm。返回带 conflict_warning 提示重复。

manage —— 管理

按 action 路由：list_pending / forget（软删除）/ restore / get_by_id / discard_pending（撤回本触角投喂、尚未归巢的候选）。隐私仓条目触角不可取/删/恢复。

get_context —— 接入开场

{"limit": 8}

一次拉「当前主线 + 待办执行」两仓最近记忆，作会话上下文底座。

say —— 在协作台发言

{"summary": "首页改版已交付，等你看效果", "stage": "done", "to": "master"}

发言者身份由服务端从凭证推导，传 actor 无效 —— 防冒充。这不是限制：板上的话是谁说的，就是真的。

board —— 读协作板

{"limit": 20, "roster": true}

返回最近 N 条发言 + 一个游标。下次把游标填进 since，就只看那之后的新内容。roster: true 额外返回值班表（谁在岗、在干什么）。

它不是推送，是各自读同一本账：每个 Agent 按自己的节拍醒来读一遍就行，不需要常驻连接，也不需要消息队列。

隐私边界（写进注册表）

触角类型公开四仓隐私四仓
云端触角（mcp / mobile）✅ 全开放🔒 锁死
本地触角（非 cloud）✅ 全开放✅ 放开

查不到注册表的「幽灵触角」默认锁死（安全兜底）。

接入后，Claude 可以

  1. 开场 get_context 了解你最近在忙啥
  2. 对话中 recall 调出「上次说的那个项目」
  3. 你说「这个该存下来」→ 它 propose 进候选区
  4. 你回电脑在候选区确认归巢
  5. 干完一段 say 一句，另一个 AI 下次 board 就接得上

记忆在蜂巢永驻，换多少茬 Agent 都无缝接上。

← 返回首页