Chat Relay Mcp

Created By
akshatmalik-bruh21 days ago
Chat Relay MCP is a local-first MCP server that lets you continue AI conversations seamlessly across IDEs like Cursor and Antigravity. It stores conversation history, architecture decisions, and important context in a local SQLite database so you can restore sessions instantly without re-explaining your entire project. Open source, lightweight, fully local, and designed for fast AI workflow handoffs between tools.
Overview

🌐 Chat Relay MCP

npm version License: MIT MCP Protocol

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:

ToolDescription
create_sessionInitialize a new context tracking session with a unique ID.
save_messagesBatch save conversation history to the persistent database.
add_memoryStore specific facts or architectural decisions for long-term recall.
get_sessionGenerate a comprehensive Handoff Prompt to transfer context to another IDE.
list_sessionsRetrieve a directory of active context-sharing sessions.
delete_sessionSecurely 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

Server Config

{
  "mcpServers": {
    "chat-relay": {
      "command": "npx",
      "args": [
        "-y",
        "chat-relay-mcp"
      ]
    }
  }
}
Project Info
Created At
21 days ago
Updated At
13 days ago
Author Name
akshatmalik-bruh
Star
-
Language
-
License
-
Category

Recommend Servers

View All