本地MCP内存服务器
本地MCP内存服务器是一个MongoDB支持的协调层，用于需要隔离内存以外的MCP客户端。它为代理和人类提供了一个共享系统，用于持久上下文、项目描述符、任务、问题、活动跟踪、软锁和协作安全状态更新。
官方文件：https://coderooz.github.io/Local-MCP-Memory-Server/
______________________________________________________________________
概述
该项目将通常的“代理执行，用户等待”流程升级为更安全的协作模型，在该模型中，代理可以与用户和其他代理并行工作，而不会丢失项目上下文或默默地践踏彼此的更改。
堆栈是：
- MCP标准传输
mcp-server.js - API快递
server.js - MongoDB持久性用于内存、版本、活动、锁、任务、问题、消息、指标和项目智能
功能亮点
- 基线项目标识和规则的项目描述符系统
- 具有排名、生命周期状态和版本历史的持久内存
- 实时活动流，用于代理和用户可见的项目跟踪
- 文件、模块、任务和其他共享资源的软资源锁
- 具有优先级评分、调度和能力感知自动分配的任务编排
- 与记忆和任务相关的问题和笔记跟踪
- 具有基于心跳的状态跟踪的代理注册表
- 可重用代码库结构知识的项目图
- 上下文图检索，链接内存、任务、问题、操作、版本和相关代理
- 任务完成、内存使用和协作信号的指标
人类+代理协作
服务器现在支持安全的并行协作：
- 代理可以发布实时活动条目
- 代理可以在共享工作之前获取软锁
- 更新可以包括用于重叠检测的预期版本或时间戳
- 冲突的更新会作为警告显示，而不是隐藏
- 任务所有权和活动锁有助于减少意外重叠
这是为了警告和协调，而不是硬阻挡人类。
快速开始
- 安装依赖项：
npm install- 创建
.env:
MONGO_URI=mongodb://localhost:27017/mcp_memory
PORT=4000
MCP_AGENT=codex
MCP_PROJECT=local-mcp-server
MCP_SCOPE=project
MCP_SERVER_URL=http://localhost:4000- 运行API：
npm run start:api- 运行MCP服务器：
npm start- 对于编辑器集成，首选：
node /absolute/path/to/mcp-shim.js- 运行生产混乱门：
node scripts/chaos-test.js使用情况摘要
典型系统模式流程：
- 阅读项目描述符
- 搜索记忆
- 获取任务和消息
- 检查最近的活动和活动锁
- 索赔或更新工作
- 做出改变
- 存储可重用内存、记录操作和释放锁
关键MCP工具现在包括：
set_project_descriptor,get_project_descriptorstore_context,search_context,update_context,get_connected_contextcreate_task,fetch_tasks,assign_task,update_taskcreate_issue,resolve_issue,fetch_issuesrecord_activity,fetch_activityacquire_resource_lock,release_resource_lock,fetch_resource_locksregister_agent,heartbeat_agent,list_agentscreate_project_map,fetch_project_mapfetch_metrics,log_action,get_logs
文档
这 docs/ 文件夹包含GitHub Pages网站，现在包括：
- 系统目的和架构
- 项目描述符和项目标识
- 活动跟踪与软锁协作
- API和MCP工具参考
- 人机协作指南
- 可靠性模型与混沌验证(
docs/reliability.md)
在存储库上启用GitHub Pages并使用 /docs 作为发布它的来源。
验证
运行：
npm test运行发布混乱验证：
npm run chaos:test该脚本打印一个结构化的JSON报告，其中包含：
- 协议完整性(
stdioJSON-RPC纯度） - 工具发现和核心工具执行检查
- 多会话隔离检查
- 成功/失败率、错误类型、响应时间统计
- 明确的
PASS/FAIL释放门
许可证
麻省理工学院