mnehmos.synch.mcp
](https://www.npmjs.com/package/mnehmos-synch-mcp)  
人工智能代理全球记忆库
一个MCP服务器,为跨会话和项目的AI代理提供持久的上下文同步。
特性
- 活动上下文 -获取/设置每个项目的当前工作状态
- 文件柜 -使用摘要和元数据对文件进行索引,以实现快速检索
- 记忆搜索 -在所有索引内容中搜索
- 空间地图 -“PC即房间”文件夹导航隐喻
- 缺陷追踪系统 -记录并解决代理工作流的错误
- 锁管理 -并发代理访问协调
- 上下文事件 -代理间切换协议
安装
先决条件: Node.js 18.0.0或更高版本
来自NPM(推荐)
npm install -g mnehmos-synch-mcp来源
git clone https://github.com/Mnehmos/mnehmos.synch.mcp.git
cd mnehmos.synch.mcp
npm install
npm run build配置
添加到您的MCP客户端配置(Claude Desktop、Cline等):
{
"mcpServers": {
"mnehmos-synch-mcp": {
"command": "npx",
"args": ["mnehmos-synch-mcp"]
}
}
}或者,如果全局安装:
{
"mcpServers": {
"mnehmos-synch-mcp": {
"command": "mnehmos-synch-mcp"
}
}
}工具
上下文管理
| 工具 | 说明 |
|---|---|
get_active_context | 获取项目的当前摘要/焦点 |
set_active_context | 更新活动上下文状态 |
list_projects | 列出内存库中的所有项目 |
文件柜
| 工具 | 说明 |
|---|---|
file_to_cabinet | 使用摘要和元数据对文件进行索引 |
get_from_cabinet | 检索索引文件信息 |
search_memory | 在所有索引内容中搜索 |
空间地图
| 工具 | 说明 |
|---|---|
get_spatial_map | 将文件夹结构设置为“房间” |
add_room | 将文件夹添加到空间地图 |
link_rooms | 连接两个文件夹 |
缺陷追踪系统
| 工具 | 说明 |
|---|---|
log_bug | 记录一个bug以便以后修复 |
get_bugs | 按项目/状态获取bug |
resolve_bug | 将错误标记为已解决 |
并发访问
| 工具 | 说明 |
|---|---|
acquire_lock | 锁定资源以进行独占访问 |
release_lock | 松开锁 |
get_lock_status | 检查锁定状态 |
代理商协调
| 工具 | 说明 |
|---|---|
emit_context_event | 发出切换/检查点/错误事件 |
get_context_events | 获取最近的上下文事件 |
服务器配置
| 工具 | 说明 |
|---|---|
configure_server | 首次运行服务器位置设置 |
get_server_info | 获取服务器配置 |
用法
// Set active context for a project
await client.callTool("set_active_context", {
project_id: "my-app",
summary: "Working on authentication module",
focus: "src/auth/login.ts"
});
// Index a file
await client.callTool("file_to_cabinet", {
project_id: "my-app",
file_path: "src/auth/login.ts",
summary: "Login handler with JWT validation",
key_exports: ["login", "validateToken"]
});
// Search memory
await client.callTool("search_memory", {
query: "authentication",
project_id: "my-app"
});
// Emit handoff event
await client.callTool("emit_context_event", {
project_id: "my-app",
agent_id: "agent-1",
event_type: "handoff",
summary: "Completed auth module, ready for testing"
});数据存储
数据存储在SQLite本地,Markdown文件回退:
| 平台 | 位置 |
|---|---|
| 视窗 | %USERPROFILE%\.agent-synch\ |
| macOS/Linux | ~/.agent-synch/ |
存储包括:
agent_synch.db-SQLite数据库projects/{id}/-每个项目的标记文件.locks/-锁定文件以进行崩溃恢复
发展
# Install dependencies
npm install
# Development mode with watch
npm run dev
# Run tests
npm test
# Build for production
npm run build许可证
麻省理工学院
