Uses SQLite as the persistent storage backend for AI agent memory data, including active contexts, file indexes, spatial maps, bugs, locks, and context events.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Mnehmos Synchsearch memory for authentication bugs in my-app project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mnehmos.synch.mcp
Global Memory Bank for AI Agents
An MCP server that provides persistent context synchronization for AI agents across sessions and projects.
Features
Active Context - Get/set current working state per project
Filing Cabinet - Index files with summaries and metadata for fast retrieval
Memory Search - Search across all indexed content
Spatial Map - "PC as Rooms" folder navigation metaphor
Bug Tracking - Log and resolve bugs for agent workflows
Lock Management - Concurrent agent access coordination
Context Events - Agent-to-agent handoff protocol
Installation
Prerequisites: Node.js 18.0.0 or higher
From NPM (Recommended)
npm install -g mnehmos-synch-mcpFrom Source
git clone https://github.com/Mnehmos/mnehmos.synch.mcp.git
cd mnehmos.synch.mcp
npm install
npm run buildConfiguration
Add to your MCP client config (Claude Desktop, Cline, etc.):
{
"mcpServers": {
"mnehmos-synch-mcp": {
"command": "npx",
"args": ["mnehmos-synch-mcp"]
}
}
}Or if installed globally:
{
"mcpServers": {
"mnehmos-synch-mcp": {
"command": "mnehmos-synch-mcp"
}
}
}Tools
Context Management
Tool | Description |
| Get current summary/focus for a project |
| Update active context state |
| List all projects in memory bank |
Filing Cabinet
Tool | Description |
| Index a file with summary and metadata |
| Retrieve indexed file info |
| Search across all indexed content |
Spatial Map
Tool | Description |
| Get folder structure as "rooms" |
| Add folder to spatial map |
| Connect two folders |
Bug Tracking
Tool | Description |
| Log a bug for later fixing |
| Get bugs by project/status |
| Mark bug as resolved |
Concurrent Access
Tool | Description |
| Lock a resource for exclusive access |
| Release a held lock |
| Check lock state |
Agent Coordination
Tool | Description |
| Emit handoff/checkpoint/error events |
| Get recent context events |
Server Configuration
Tool | Description |
| First-run setup for server location |
| Get server configuration |
Usage
// 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"
});Data Storage
Data is stored locally in SQLite with Markdown file fallbacks:
Platform | Location |
Windows |
|
macOS/Linux |
|
Storage includes:
agent_synch.db- SQLite databaseprojects/{id}/- Per-project markdown files.locks/- Lock files for crash recovery
Development
# Install dependencies
npm install
# Development mode with watch
npm run dev
# Run tests
npm test
# Build for production
npm run buildLicense
MIT