Chat Relay Mcp
About
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 wi
Details
- Author
- akshatmalik-bruh
- Downloads
- 279
- Categories
- AI
Jump to
- Persistent Continuity: Automatically saves and syncs AI memories across sessions using a local SQLite database.
- Cross-IDE Handoff: Transfer conversation context between different IDEs (e.g., Cursor to Antigravity).
- Zod-Validated Integrity: Strict schema validation ensures clean, structured data free from hallucinations.
- Local-First Privacy: All data stays on your machine; no external cloud dependencies or third-party storage.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Chat Relay McpCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Add Chat Relay Mcp to your IDE’s MCP configuration. For Cursor: open Settings → General → MCP → Add New MCP Server, set type to command, and paste npx -y chat-relay-mcp as the command. For Antigravity: go to Settings → Advanced → MCP Settings → Edit Config File and add a chat-relay entry under mcpServers with the same command and args.
create_session
Create a new context-sharing session (e.g. 'auth-service')
save_messages
Save a batch of conversation messages to a session
add_memory
Save a specific decision or fact to a session's long-term memory
get_session
Retrieve the full context handoff prompt for a specific session ID
list_sessions
List all available context-sharing sessions
delete_session
Delete a session and all its associated data
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"chat relay mcp": {
"chat-relay": {
"command": "npx",
"args": [
"-y",
"chat-relay-mcp"
]
}
}
}
}McpServers
{
"chat-relay": {
"command": "npx",
"args": [
"-y",
"chat-relay-mcp"
]
}
}🌐 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 orCmd/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 thechat-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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
