Skip to main content
Glama

mnehmos.synch.mcp

npm version CI 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

Related MCP server: ai-cortex

Installation

Prerequisites: Node.js 18.0.0 or higher

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

A
license - permissive license
Not graded
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    Not graded
    quality
    B
    maintenance
    Provides durable project context for coding agents, including project maps, session history, and explicit memories, all stored locally.
    74
    6
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Provides AI coding agents with persistent, graph-connected memory across projects, enabling cross-project context retrieval via synaptic connections and hybrid search.
    18
    6
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Provides persistent, searchable memory and knowledge capture for AI-assisted development, enabling agents to retain decisions, bugs, and patterns across sessions and projects.
    MIT

View all related MCP servers

Related MCP Connectors

  • Give your AI agent a persistent map of your project's structure, dependencies, and bugs.

  • Shared, governed long-term memory for AI agents across tools and sessions via MCP and REST.

  • One shared brain for your AI coding agents: team memory, agent Q&A, tasks, and file claims.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Mnehmos/mnehmos.synch.mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server