🔄 AI-Context-Sync-MCP

Synchronize Your AI Developer Context Everywhere, Instantly.

ai-context-sync-mcp is a Model Context Protocol (MCP) server that empowers your local AI coding assistants (like Cursor, Claude Desktop, Windsurf, and VS Code) to securely push (save) and pull (semantically retrieve) development context, explanations, schemas, and chat summaries to/from a centralized database.

🌐 Web Cloud Console (Sign Up & Get API Key)

🚀 Hosted Cloud Version is Live!

Get your credentials, manage your project trees, and review active sync logs in the cloud: 👉 Open Context-Sync Web Console

• Free Account Benefits:
  • Store up to 2 Projects and 3 Context blocks per project.
  • Backend-enforced cap of 30 pushes and 30 pulls per day.
  • Masked API Key manager with instant regeneration.
• Pro Cloud Version:
  • Upgrade to the PRO Tier dynamically in the settings tab to unlock unlimited project trees, unrestricted context sizes, and unlimited daily pushes and pulls.

📦 NPM Package

The server is published to the public NPM registry and can be run dynamically without local installation: 🔗 ai-context-sync-mcp on npmjs.com

npx -y ai-context-sync-mcp

⚙️ Installation & Setup

1. Claude Desktop

Add this configuration block to your local claude_desktop_config.json settings file:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ai-context-sync-mcp": {
      "command": "npx",
      "args": ["-y", "ai-context-sync-mcp"],
      "env": {
        "CONTEXT_SYNC_API_KEY": "YOUR_API_KEY_HERE",
        "CONTEXT_SYNC_BACKEND_URL": "https://backend-production-3d8b.up.railway.app"
      }
    }
  }
}

2. Cursor IDE

1. Open Cursor Settings -> Features -> MCP.
2. Click + Add New MCP Server.
3. Configure the fields:
   • Name: ai-context-sync-mcp
   • Type: command
   • Command:
     • Windows:

       cmd /c "set CONTEXT_SYNC_API_KEY=YOUR_API_KEY_HERE&& set CONTEXT_SYNC_BACKEND_URL=https://backend-production-3d8b.up.railway.app&& npx -y ai-context-sync-mcp"
       

     • macOS / Linux:

       CONTEXT_SYNC_API_KEY=YOUR_API_KEY_HERE CONTEXT_SYNC_BACKEND_URL=https://backend-production-3d8b.up.railway.app npx -y ai-context-sync-mcp
       

3. Windsurf IDE

1. Open the Windsurf MCP Settings file at ~/.codeium/windsurf/mcp_config.json.
2. Add the configuration block:

   {
     "mcpServers": {
       "ai-context-sync-mcp": {
         "command": "npx",
         "args": ["-y", "ai-context-sync-mcp"],
         "env": {
           "CONTEXT_SYNC_API_KEY": "YOUR_API_KEY_HERE",
           "CONTEXT_SYNC_BACKEND_URL": "https://backend-production-3d8b.up.railway.app"
         }
       }
     }
   }
   

4. VS Code (Cline, Roo Code, and Custom Agents)

1. Open the global Cline configuration settings file:
   • Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
   • macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
2. Add the server details:

   {
     "mcpServers": {
       "ai-context-sync-mcp": {
         "command": "npx",
         "args": ["-y", "ai-context-sync-mcp"],
         "env": {
           "CONTEXT_SYNC_API_KEY": "YOUR_API_KEY_HERE",
           "CONTEXT_SYNC_BACKEND_URL": "https://backend-production-3d8b.up.railway.app"
         }
       }
     }
   }
   

🛠️ Provided Tools

Once configured, your AI assistants will automatically gain access to the following tools:

1. push_context

Saves your active codebase details, chat summaries, or configuration specs.

• Parameters:
  • contextData (required): The codebase structure or chat summary text.
  • projectName (optional): The name of the project container.
  • contextName (optional): A short slug name (e.g., db-migration).
  • contextDescription (optional): A verbose description used for semantic search.
  • contextType (optional): full, summary, or feature.

2. pull_context

Performs an AI semantic search (powered by Google Gemini 1.5 Flash on the backend) to locate and retrieve the most relevant context block directly into your active chat session.

• Parameters:
  • searchQuery (required): What context block you want to find.
  • projectName (optional): Limit searches to a specific project.

📄 License

This project is licensed under the MIT License.