蜂巢mcp
你的AI终于记住了。
 
______________________________________________________________________
问题
你向克劳德解释你的代码库。架构、约束、模式。然后你达到了上下文限制。新会议。 克劳德什么都忘了。
解决方案
Session 1 Session 2
───────────────────────────────────────────────────
You: "Our auth uses JWT..." You: /catchup
Claude: *learns* Claude: "I remember:
↓ - Auth uses JWT with refresh
/wrap - Convention: validate at boundaries
↓ What should we work on?"
[Memory] ────────────────►具有语义搜索的持久性、项目范围内存。惯例、决定、片段——存储在本地,永远不会被遗忘。
______________________________________________________________________
是什么让hive mcp与众不同
| 功能 | hive mcp | 典型的mcp服务器 |
|---|---|---|
| 知识图谱 | 结构边缘——知识是如何关联的? | 仅限平面键值或矢量 |
| 会话连续性 | /wrap 结晶, /catchup 重建--在会话间重新解释 | 手动复制粘贴或丢失 |
| 多智能体协调 | Lings(策划者)+无人机(执行者),带有文件索赔、hivemind呼喊和连续生产带 | 仅限单个代理 |
| 作用域内存 | 分层上下文检索(HCR)-项目范围-具有TTL衰减 | 全局命名空间或无 |
| 扩展架构 | requiring-resolve 带有noop回退的存根-插入您的扩展并播放 | 单片 |
______________________________________________________________________
快速开始
1.安装
选项A:自动化 hive mcp-cli (推荐)
# Requires Go 1.21+
go install github.com/hive-agi/hive-mcp-cli/cmd/hive@latest
go install github.com/hive-agi/hive-mcp-cli/cmd/hive-setup-mcp@latest
# Register and let Claude guide setup
claude mcp add hive-setup --scope user -- hive-setup-mcp
claude
# Ask: "Help me setup hive-mcp"选项B:手动
export HIVE_MCP_DIR="$HOME/hive-mcp"
export BB_MCP_DIR="$HOME/bb-mcp"
git clone https://github.com/hive-agi/hive-mcp.git "$HIVE_MCP_DIR"
git clone https://github.com/hive-agi/bb-mcp.git "$BB_MCP_DIR"
claude mcp add hive --scope user -- "$HIVE_MCP_DIR/start-bb-mcp.sh"2.验证
claude mcp list | grep -q "hive" && echo "OK" || echo "FAILED"3.可选:语义搜索
ollama pull nomic-embed-text # Local embeddings
docker compose up -d # Chroma vector DB先决条件
| 需求 | 版本 | 安装 |
|---|---|---|
| 克劳德代码 | 最新 | claude.ai/下载 |
| 巴巴什卡 | 1.3+ | babashka.org |
| Java | 17+ | apt install openjdk-17-jdk |
可选的:
- Emacs 28.1+用于swarm vterm UI和缓冲区集成。看 Emacs配置.
- 无头模式在没有Emacs的情况下工作(但为了无头的稳定性,建议使用Emacs作为依赖)。
______________________________________________________________________
20个综合工具
| 工具 | 目的 |
|---|---|
memory | 具有语义搜索、TTL衰减、范围界定的持久条目 |
kg | 知识图——边、子图 |
agent | 产卵/杀死/派遣灵鸟和无人机 |
wave | 并行无人机调度与验证 |
hivemind | 喊/问代理人之间的协调 |
session | 包装,追赶,哇,上下文存储 |
workflow | 锻造带,FSM驱动的生产周期 |
kanban | 从计划到看板的任务管理 |
magit | Git操作——状态、阶段、提交、推送 |
cider | Clojure nREPL评估、文档、完成 |
preset | 代理预设--列表、搜索、生成标题 |
analysis | Kondo lint、SCC指标、复杂性热点 |
lsp | 代码分析——调用者、调用、命名空间图 |
project | 投影——文件、搜索、层次扫描 |
emacs | Eval elisp、缓冲区、通知 |
olympus | 多代理UI的网格布局控制 |
agora | 多主体审议和辩论 |
config | 运行时配置管理 |
migration | KG/内存备份、恢复、后端切换 |
multi | 元外观——批处理操作 |
每个工具都是具有子命令的合并命名空间(例如。, memory add, memory query, kg traverse).
______________________________________________________________________
建筑
Claude ──MCP──► hive-mcp (Clojure)
│
├── Memory (Chroma vectors + scoped entries)
├── Knowledge Graph (DataScript, Datalevin, or Datahike)
├── Swarm (lings + drones + hivemind)
├── Workflows for AIs (building blocks for repeatable behavior)
└── Extension Registry (requiring-resolve stubs)
│
└──► [optional] your extensions (e.g., plug openclaw, langchain, whatever etc)______________________________________________________________________
可扩展性
hive mcp使用基于 IAddon协议 具有自动类路径发现功能。创建新插件需要一个命令:
clojure -Sdeps '{:deps {io.github.hive-agi/hive-mcp {:git/tag "vX.Y.Z" :git/sha "..."}}}' \
-Tnew create :template hive-agi/addon :name com.example/my-addon这将生成一个完整的项目,其中包括:
- IAddon协议实现 (使用8种生命周期方法取消记录)
- META-INF类路径清单 (启动时自动发现,核心无变化)
- 单元测试 (涵盖生命周期、工具、健康状况的12项测试)
- REPL就绪 开发设置
插件类型
| 类型 | 用例 |
|---|---|
| 本土的 | 同一JVM中的Clojure代码——直接函数调用 |
| MCP电桥 | 通过stdio/sse代理到外部MCP服务器 |
| 外部 | 非MCP集成(REST API、CLI工具) |
运作原理
插件是通过以下方式发现的 META-INF/hive-addons/*.edn 类路径上的清单文件(与Java的模式相同 ServiceLoader).清单声明依赖关系,插件按拓扑顺序加载。无需更改hive mcp核心代码。
______________________________________________________________________
Carto商店(地图摘录)
制图片段(代码块嵌入 carto_callers / carto_definition / carto_callees)生活在一个专用的矢量库中——与普通矢量库分开 :memory-store --因此回忆调优保持独立。
默认配置(已连接 docker-compose.yml 作为服务 qdrant-carto):
{:services
{:qdrant-carto {:mode :local
:host "localhost"
:port 6333
:collection "carto-snippets"
:embedding {:provider :ollama
:model "nomic-embed-code"}}
:carto-store {:backend :qdrant-carto}}}用户覆盖示例 (~/.config/hive-mcp/config.edn):
{:services
{:qdrant-carto {:host "qdrant.internal"
:port 6333
:collection "my-carto"
:embedding {:provider :ollama
:model "nomic-embed-code"}}
:carto-store {:backend :qdrant-carto}}}如果 :carto-store 省略, hive-mcp.config.resolve/resolve-carto-store 记录警告并回退到 :memory-store --系统继续启动,但地图在共享存储中写入土地。生产部署应声明 :carto-store 明确地。
打开专用实例:
docker compose up -d qdrant-carto______________________________________________________________________
对于LLMs
看 CLAUDE.md 了解项目约定、工具模式和内存使用指南。
文档
______________________________________________________________________
相关
| 存储库 | 描述 |
|---|---|
| bb mcp | 轻量级Babashka MCP封装器(约50MB RAM) |
| lsp-mcp | Clojure LSP网桥插件(分析、调用者、引用) |
| 基本工具mcp | 文件读/写/glob/grep工具插件 |
| hive dsl | 用于批处理操作的DSL动词编译器 |
| 蜂箱试验 | hive mcp插件的测试工具 |
| 奥林巴斯网络用户界面 | 用于群体监控的Web仪表板 |
| hive mcp-cli | 转到CLI进行自动设置 |
______________________________________________________________________
