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-mcp

From Source

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 (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_active_context	Get current summary/focus for a project
set_active_context	Update active context state
list_projects	List all projects in memory bank

Filing Cabinet

Tool	Description
file_to_cabinet	Index a file with summary and metadata
get_from_cabinet	Retrieve indexed file info
search_memory	Search across all indexed content

Spatial Map

Tool	Description
get_spatial_map	Get folder structure as "rooms"
add_room	Add folder to spatial map
link_rooms	Connect two folders

Bug Tracking

Tool	Description
log_bug	Log a bug for later fixing
get_bugs	Get bugs by project/status
resolve_bug	Mark bug as resolved

Concurrent Access

Tool	Description
acquire_lock	Lock a resource for exclusive access
release_lock	Release a held lock
get_lock_status	Check lock state

Agent Coordination

Tool	Description
emit_context_event	Emit handoff/checkpoint/error events
get_context_events	Get recent context events

Server Configuration

Tool	Description
configure_server	First-run setup for server location
get_server_info	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	%USERPROFILE%\.agent-synch\
macOS/Linux	~/.agent-synch/

Storage includes:

• agent_synch.db - SQLite database
• projects/{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 build

License

MIT

Author

Mnehmos

Links

• NPM Package
• GitHub Repository
• Changelog