neurohive

neurohive

多 Agent 记忆智能——为 AI Agent 团队提供共享知识、专业能力跟踪和冲突检测。

为什么需要

团队中的 AI Agent 会忘记所有事情，也不会共享知识。在同一项目上工作的多个 Agent 会重复发现相同事实、彼此矛盾，而且没有集体记忆。一个 Agent 了解到 API 超时是 30 秒；另一个则认为是 60 秒。两个结论分别留在不同会话中，从未被比较。

neurohive 为 neuromcp 加上了共享智能层。任何 Agent 存储的记忆都会对团队可见。搜索结果会附上是谁、何时发现了什么。新 Agent 加入时，团队现有的知识会自动载入。冲突会在引发事故前得到标记。

使用前后对比

	仅使用 neuromcp	使用 neurohive
Agent 知识	每个会话相互隔离	团队共享，并注明来源
搜索结果	原始结果	附注“由 Agent-X 于 3 分钟前发现”
新 Agent 入门	从零开始	预先载入团队的核心知识
专业能力	不知道谁掌握什么	跟踪记录：“Agent-Backend：API（31），Auth（22）”
冲突	悄然并存	标记：“Backend 认为超时为 30 秒，DevOps 认为是 60 秒”
团队概览	无	提供知识图谱、缺口和活动情况的仪表板

快速开始

npx neurohive

可直接替换 npx neuromcp。使用相同的 MCP 配置，只需替换命令即可。所有 neuromcp 工具和资源都能照常使用，此外还提供三个新的 neurohive 工具、五个新资源，以及自动跨 Agent 注释功能。

功能

跨 Agent 注释

每条搜索结果都会附上来源信息：由哪个 Agent 存储、存储了多久，以及被检索过多少次。Agent 可以一眼看出某条记忆来自可信的队友，还是未知来源。

Agent 预载

Agent 启动时，会读取 hivemind://priming 资源，载入团队的核心知识、近期活动和已知缺口。无需从零开始。

专业能力跟踪

每当 Agent 存储一条记忆，neurohive 就会更新该 Agent 的专业能力档案，跟踪其主要贡献的类别。使用 hivemind_expertise 来分配问题：“谁最了解身份验证？”

冲突检测

当两个 Agent 存储了关于同一事实的矛盾说法时，neurohive 会将其标记为冲突。冲突会显示在 hivemind_conflicts 和仪表板中，以便团队明确解决，而不是任由过时数据悄然传播。

仪表板

只需一条命令，即可实时查看集体知识库：记忆总数、活跃 Agent、热门类别、近期活动、未解决的冲突和知识缺口。

安装

Claude Code

{
  "mcpServers": {
    "neurohive": {
      "command": "npx",
      "args": ["neurohive"],
      "env": {
        "HIVEMIND_COMPANY": "my-project",
        "HIVEMIND_AGENT": "Agent-Backend",
        "HIVEMIND_AGENT_ROLE": "backend"
      }
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "neurohive": {
      "command": "npx",
      "args": ["-y", "neurohive"],
      "env": {
        "HIVEMIND_COMPANY": "my-project",
        "HIVEMIND_AGENT": "Agent-Frontend"
      }
    }
  }
}

Cursor

{
  "mcpServers": {
    "neurohive": {
      "command": "npx",
      "args": ["neurohive"],
      "env": {
        "HIVEMIND_COMPANY": "my-project",
        "HIVEMIND_AGENT": "Cursor-Agent"
      }
    }
  }
}

Paperclip 模式

当 Paperclip 在本地运行时，neurohive 会自动检测并通过 Paperclip API 读取公司、Agent 和角色信息。无需额外的环境变量——公司命名空间会根据当前启用的 Paperclip 公司设置，每个 Agent 则通过其 Paperclip 身份进行识别。

手动备用方案（Paperclip 未运行时）：

HIVEMIND_PAPERCLIP_URL=http://localhost:3100   # default
HIVEMIND_COMPANY=my-project
HIVEMIND_AGENT=Agent-Backend
HIVEMIND_AGENT_ROLE=backend

CLI 命令

命令	描述
neurohive	以 MCP 服务身份启动（stdio）
neurohive dashboard	打印团队知识仪表板
neurohive expertise [topic|agent_id]	显示专业能力图谱，或查询主题/Agent
neurohive conflicts [--all]	列出未解决的冲突（--all 包括已解决的冲突）
neurohive doctor	健康检查：数据库路径、Agent 配置、Paperclip 状态

配置

neurohive 变量

变量	默认值	描述
HIVEMIND_COMPANY	""	公司／项目名称。将共享命名空间设为 company-<name>
HIVEMIND_AGENT	""	Agent 标识符（例如 Agent-Backend、Agent-DevOps）
HIVEMIND_AGENT_ROLE	""	用于预置上下文的 Agent 角色标签
HIVEMIND_PAPERCLIP_URL	http://localhost:3100	用于自动检测的 Paperclip API URL
HIVEMIND_PRIMING_COUNT	10	预置上下文中包含的顶级记忆数量
HIVEMIND_PRIMING_CATEGORIES	""	预置时优先考虑的类别，以逗号分隔

neuromcp 透传变量

所有 NEUROMCP_* 环境变量均原样透传。主要变量：

变量	默认值	描述
NEUROMCP_DB_PATH	~/.neuromcp/memory.db	SQLite 数据库路径
NEUROMCP_LOG_LEVEL	info	日志级别：debug、info、warn、error
NEUROMCP_EMBEDDING_PROVIDER	local	嵌入提供方：local、openai、ollama
OPENAI_API_KEY	—	使用 OpenAI 嵌入时必需

MCP 功能

neurohive 提供 16 个工具、18 个资源和 3 个提示词。

工具

13 个 neuromcp 工具（保持不变）：

工具	描述
store_memory	使用蜂巢注释存储记忆
search_memory	支持跨 Agent 归因的混合搜索
recall_memory	按 ID、命名空间、类别或标签检索
forget_memory	按筛选条件软删除记忆
consolidate	合并重复项、降低陈旧记忆权重、清除低价值记忆
memory_stats	计数、类别和信任级别统计
export_memories	导出为 JSONL 或 JSON
import_memories	导入并去重
backfill_embeddings	重新计算缺失的嵌入
create_entity	创建／更新知识图谱实体
create_relation	在知识图谱中关联实体
query_graph	遍历知识图谱
search_claims	搜索提取出的原子声明

3 个 neurohive 工具：

工具	描述
hivemind_status	团队仪表板：Agent、类别、冲突和活动情况
hivemind_expertise	查询谁了解哪些内容；获取 Agent 专业知识档案
hivemind_conflicts	列出／解决 Agent 间的矛盾

资源

13 个 neuromcp 资源（记忆、图谱、预置和统计）以及 5 个 neurohive 资源：

资源 URI	描述
hivemind://priming	启动上下文：用于新成员入门的仪表板和顶级知识
hivemind://expertise	所有 Agent 专业知识数据，以 JSON 格式呈现
hivemind://conflicts	未解决的冲突，以 JSON 格式呈现
hivemind://dashboard	完整的仪表板数据，以 JSON 格式呈现
hivemind://agent/{agentId}	特定 Agent 的专业知识档案

提示词

3 个 neuromcp 提示词：store_memory_prompt、search_memory_prompt、session_summary_prompt。

Paperclip 集成

neurohive 启动时会探测 HIVEMIND_PAPERCLIP_URL。如果 Paperclip API 有响应：

1. 命名空间设为 company-<companyId>——同一 Paperclip 公司的所有 Agent 共享一个知识库。
2. Agent 身份从 Paperclip Agent 记录中读取，因此可自动识别团队中的每个 Agent。
3. 角色从 Agent 定义中获取，用于丰富预置上下文（“你是后端 Agent；以下是你的团队掌握的知识”）。

如果 Paperclip 未运行，neurohive 会回退到 HIVEMIND_COMPANY／HIVEMIND_AGENT 环境变量，功能不受影响。

要求

要求	必需	说明
Node.js >= 18	是	ESM 运行时
neuromcp	是	自动作为依赖项安装
Paperclip	否	在配置的 URL 上运行时自动检测
OpenAI API 密钥	否	仅在使用 OpenAI 嵌入时需要

平台支持

平台	状态
macOS	完全支持
Linux	完全支持
WSL2	支持
Windows（原生）	不支持

常见问题

这是 neuromcp 的替代品吗？ 是，也不是。neurohive 基于 neuromcp 运行，并重新导出其所有工具、资源和提示词。如果你只运行一个 Agent，它在功能上与 neuromcp 完全相同，只多出一些工具。当两个或更多 Agent 共享同一个 HIVEMIND_COMPANY 命名空间时，neurohive 的价值才会体现出来。

所有 Agent 是否共享同一个数据库？ 是的——同一公司命名空间中的 Agent 通过共享文件系统路径（NEUROMCP_DB_PATH）共享数据库。这适用于在同一台机器上运行多个 Agent 的场景（Paperclip、dmux、并行运行的 Claude Code 会话）。对于分布式环境，请将所有 Agent 指向共享的 NFS 或网络路径。

什么情况算冲突？ 当来自不同 Agent 的两条记忆对同一主题提出相互矛盾的主张时，就算冲突。冲突检测会在存储时运行，使用从记忆内容中提取的认知主张。你可以通过 neuromcp 配置调整检测灵敏度或禁用此功能。

这会破坏我现有的 neuromcp 配置吗？ 不会。neurohive 会原样传递所有现有的 NEUROMCP_* 环境变量，并写入同一个数据库。你可以随时切换回 npx neuromcp。

预置如何运作？ 启动时，读取 hivemind://priming 的 Agent 会收到一份格式化摘要，其中包括团队规模、热门类别、最活跃的 Agent、近期记忆以及任何未解决的冲突。该摘要旨在纳入系统提示词，或通过会话启动时的钩子读取。

贡献

请参阅 CONTRIBUTING.md。

许可证

MIT — 请参阅 LICENSE。