Local MCP Memory Server

本地MCP内存服务器

    

本地MCP内存服务器是一个MongoDB支持的协调层，用于需要隔离内存以外的MCP客户端。它为代理和人类提供了一个共享系统，用于持久上下文、项目描述符、任务、问题、活动跟踪、软锁和协作安全状态更新。

官方文件：https://coderooz.github.io/Local-MCP-Memory-Server/

______________________________________________________________________

概述

该项目将通常的“代理执行，用户等待”流程升级为更安全的协作模型，在该模型中，代理可以与用户和其他代理并行工作，而不会丢失项目上下文或默默地践踏彼此的更改。

堆栈是：

• MCP标准传输 mcp-server.js
• API快递 server.js
• MongoDB持久性用于内存、版本、活动、锁、任务、问题、消息、指标和项目智能

功能亮点

• 基线项目标识和规则的项目描述符系统
• 具有排名、生命周期状态和版本历史的持久内存
• 实时活动流，用于代理和用户可见的项目跟踪
• 文件、模块、任务和其他共享资源的软资源锁
• 具有优先级评分、调度和能力感知自动分配的任务编排
• 与记忆和任务相关的问题和笔记跟踪
• 具有基于心跳的状态跟踪的代理注册表
• 可重用代码库结构知识的项目图
• 上下文图检索，链接内存、任务、问题、操作、版本和相关代理
• 任务完成、内存使用和协作信号的指标

人类+代理协作

服务器现在支持安全的并行协作：

• 代理可以发布实时活动条目
• 代理可以在共享工作之前获取软锁
• 更新可以包括用于重叠检测的预期版本或时间戳
• 冲突的更新会作为警告显示，而不是隐藏
• 任务所有权和活动锁有助于减少意外重叠

这是为了警告和协调，而不是硬阻挡人类。

快速开始

1. 安装依赖项：

npm install

1. 创建 .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

1. 运行API：

npm run start:api

1. 运行MCP服务器：

npm start

1. 对于编辑器集成，首选：

node /absolute/path/to/mcp-shim.js

1. 运行生产混乱门：

node scripts/chaos-test.js

使用情况摘要

典型系统模式流程：

1. 阅读项目描述符
2. 搜索记忆
3. 获取任务和消息
4. 检查最近的活动和活动锁
5. 索赔或更新工作
6. 做出改变
7. 存储可重用内存、记录操作和释放锁

关键MCP工具现在包括：

• set_project_descriptor, get_project_descriptor
• store_context, search_context, update_context, get_connected_context
• create_task, fetch_tasks, assign_task, update_task
• create_issue, resolve_issue, fetch_issues
• record_activity, fetch_activity
• acquire_resource_lock, release_resource_lock, fetch_resource_locks
• register_agent, heartbeat_agent, list_agents
• create_project_map, fetch_project_map
• fetch_metrics, log_action, get_logs

文档

这 docs/ 文件夹包含GitHub Pages网站，现在包括：

• 系统目的和架构
• 项目描述符和项目标识
• 活动跟踪与软锁协作
• API和MCP工具参考
• 人机协作指南
• 可靠性模型与混沌验证(docs/reliability.md)

在存储库上启用GitHub Pages并使用 /docs 作为发布它的来源。

验证

运行：

npm test

运行发布混乱验证：

npm run chaos:test

该脚本打印一个结构化的JSON报告，其中包含：

• 协议完整性(stdio JSON-RPC纯度）
• 工具发现和核心工具执行检查
• 多会话隔离检查
• 成功/失败率、错误类型、响应时间统计
• 明确的 PASS/FAIL 释放门

许可证

麻省理工学院