Which integrations are available for this server?

Uses SQLite as the persistent storage backend for AI agent memory data, including active contexts, file indexes, spatial maps, bugs, locks, and context events.

How do I use Mnehmos Synch?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Mnehmos Synch search 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

npm version License: MIT

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

This server cannot be installed

A

license - permissive license

-

quality - not tested

D

maintenance

How are these scores calculated?

Resources

Need Help?

Related Servers

Mnehmos Synch