🌐 Chat Relay MCP

Chat Relay MCP is a high-fidelity Model Context Protocol server designed to bridge the gap between AI-powered IDEs. It provides a persistent, local-first bridge to sync chat sessions, AI memories, and project context across Cursor, Antigravity, VS Code, and more.

[!NOTE] Compatibility: Tested and optimized for Cursor and Antigravity.

✨ Key Features

• Persistent Continuity: Automatically saves and syncs AI memories across separate sessions using a local SQLite database.
• Cross-IDE Handoff: Effortlessly transfer conversation context between different IDE (e.g., from Cursor to Antigravity).
• Zod-Validated Integrity: Strict schema validation ensures AI-generated data is clean, structured, and free from hallucinations.
• Local-First Privacy: All data stays on your machine. No external cloud dependencies or third-party storage.

🚀 Quick Start

To use Chat Relay, you need to add it to your IDE's MCP configuration.

1. Configuration for Cursor

1. Open Cursor Settings (Gear icon or Cmd/Ctrl + Shift + J).
2. Navigate to General -> MCP.
3. Click on + Add New MCP Server.
4. Set the name to chat-relay.
5. Set the type to command.
6. Paste the following into the Command field:

   npx -y chat-relay-mcp

2. Configuration for Antigravity

1. Open Antigravity Settings.
2. Go to Advanced -> MCP Settings.
3. Click Edit Config File.
4. Ensure your configuration includes the chat-relay entry inside the mcpServers block:

{
  "mcpServers": {
    "chat-relay": {
      "command": "npx",
      "args": ["-y", "chat-relay-mcp"]
    }
  }
}

🛠️ Tools Available

The relay exposes a suite of tools that your AI can use to manage context:

| Tool | Description | |------|-------------| | create_session | Initialize a new context tracking session with a unique ID. | | save_messages | Batch save conversation history to the persistent database. | | add_memory | Store specific facts or architectural decisions for long-term recall. | | get_session | Generate a comprehensive Handoff Prompt to transfer context to another IDE. | | list_sessions | Retrieve a directory of active context-sharing sessions. | | delete_session | Securely wipe all data associated with a specific session. |

💻 Local Development

If you want to modify the server or run it from source:

1. Clone the repository:

   git clone https://github.com/akshatmalik-bruh/ClientRelayMcp.git
   cd ClientRelayMcp

2. Install dependencies:

   npm install

3. Build the server:

   npm run build

4. Run in dev mode:

   npm run dev

📜 License

Distributed under the MIT License. See LICENSE for more information.

Built by Akshat Malik