使用说明
Mevoric
Claude Code的统一内存+代理桥。一台MCP服务器,12个工具,零配置。
它的作用
- 语义记忆 --使用远程内存服务器跨会话存储和调用对话
- 跨标签消息 --在Claude Code选项卡之间实时发送消息
- 上下文共享 --在代理之间共享工作知识,会话结束后继续
- 会话检查点 --自动保存和恢复结构化会话状态
安装
npx mevoric init --server http://your-server:4000
这个命令:
- 将MCP服务器添加到
~/.claude/.mcp.json - 更新任何项目级别
.mcp.json包含旧条目的文件 - 在中配置挂钩
~/.claude/settings.json - 删除旧软件包(
newcode-memory,agent-bridge-mcp)如果已安装
运行后重新启动VS Code。
12工具
| 组 | 工具 |
|---|---|
| 记忆 | retrieve_memories, store_conversation, judge_memories |
| 桥 | register_agent, list_agents, send_message, read_messages, broadcast |
| 上下文 | share_context, get_context |
| 检查点 | save_checkpoint, load_checkpoint |
3个挂钩(自动配置)
| 事件 | 它做什么 |
|---|---|
| 会话开始 | 加载共享上下文、挂起的消息和检查点 |
| 用户提示: | 捕获提示+传递挂起的代理消息 |
| 停止 | 将提示+响应、POST与内存服务器配对,保存上下文+检查点 |
内存服务器
记忆工具(retrieve_memories, store_conversation, judge_memories)需要一个处理语义搜索、嵌入和存储的后端服务器。梅沃里克是 客户端 --它调用您的服务器 /retrieve, /ingest,以及 /feedback 端点。
如果没有配置内存服务器,9桥/上下文/检查点工具仍然可以正常工作。内存工具将优雅地返回错误。
在初始化过程中设置服务器URL:
npx mevoric init --server http://your-memory-server:port
或者将其设置为环境变量:
MEVORIC_SERVER_URL=http://your-memory-server:port
环境变量
| 变量 | 默认值 | 描述 |
|---|---|---|
MEVORIC_SERVER_URL |
(无) | 内存服务器URL(内存工具需要) |
MEVORIC_DATA_DIR |
特定于操作系统的应用程序数据 | 代理数据、消息、上下文的目录 |
MEVORIC_AGENT_NAME |
(自动生成) | 此代理的人类可读名称 |
运作原理
Mevoric通过stdio作为单个Node.js MCP服务器运行。Claude Code会自动启动它。
布里奇探员: 每个Claude Code选项卡都注册为具有名称的代理。代理通过数据目录中的基于文件的消息传递进行通信。心跳文件跟踪活动性——停止写入心跳的代理会自动清理。
内存: 在会话结束时,Stop钩子将用户的提示与助手的响应配对,并将其POST到内存服务器进行存储。在下一次会话中, retrieve_memories 搜索相关的过去对话。
检查点: 工作状态的结构化快照(任务、接触的文件、做出的决定)。会话结束时自动保存,会话开始时自动加载。24小时后过期。
需求
- Node.js 18+
- Claude 代码命令行工具
许可证
麻省理工学院
