Mnehmos Synch

# 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 ```bash git clone https://github.com/Mnehmos/mnehmos.synch.mcp.git cd mnehmos.synch.mcp npm install npm run build ``` ## Configuration Add to your MCP client config: ```json { "mcpServers": { "mnehmos.synch.mcp": { "command": "node", "args": ["F:\\Github\\mnehmos.synch.mcp\\dist\\index.js"] } } } ``` ## Tools | Tool | Description | |------|-------------| | `get_active_context` | Get current summary/focus for a project | | `set_active_context` | Update active context state | | `file_to_cabinet` | Index a file with summary and metadata | | `get_from_cabinet` | Retrieve indexed file info | | `search_memory` | Search across all indexed content | | `list_projects` | List all projects in memory bank | | `get_spatial_map` | Get folder structure as "rooms" | | `add_room` | Add folder to spatial map | | `link_rooms` | Connect two folders | | `log_bug` | Log a bug for later fixing | | `get_bugs` | Get bugs by project/status | | `resolve_bug` | Mark bug as resolved | | `acquire_lock` | Lock a resource for exclusive access | | `release_lock` | Release a held lock | | `get_lock_status` | Check lock state | | `emit_context_event` | Emit handoff/checkpoint/error events | | `get_context_events` | Get recent context events | ## Usage ```typescript // 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 in SQLite at: - **Windows:** `%APPDATA%\mnehmos-synch\` - **macOS/Linux:** `~/.config/mnehmos-synch/` ## License MIT ## Author Mnehmos