Recursor MCP Server (Node.js)

Official Node.js implementation of the Model Context Protocol (MCP) server for Recursor. This server allows AI assistants (like Claude Desktop, Cursor, etc.) to access Recursor's memory and coding history.

Features

• Search Memory: Find relevant coding patterns and past corrections.
• Add Correction: Record new corrections and improvements to learn from.
• Safety Checks: Validate code snippets against guardrails.
• Automatic Analytics: Tracks tool usage to improve the system.

Installation

Prerequisites

• Node.js >= 18
• Recursor API Key

Global Installation

npm install -g @recursorsdk/mcp

Configuration

The server requires the following environment variables:

| Variable | Description | Required | Default | |----------|-------------|----------|---------| | RECURSOR_API_KEY | Your Recursor API Key | Yes | - | | RECURSOR_API_URL | Recursor API base URL | No | https://recursor.dev/v1 | | RECURSOR_PROJECT_ID | Project ID for tracking | No | - |

Usage

Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "recursor": {
      "command": "npx",
      "args": ["-y", "@recursorsdk/mcp"],
      "env": {
        "RECURSOR_API_KEY": "your_api_key_here",
        "RECURSOR_PROJECT_ID": "your_project_id_here"
      }
    }
  }
}

Local Development

1. Clone the repository
2. Install dependencies: npm install
3. Build the project: npm run build
4. Run the server: node dist/index.js (stdio mode)

Tools

search_memory

Search Recursor's memory for relevant coding patterns, past corrections, or guidelines.

add_correction

Record a correction or improvement to the system's memory.

check_safety

Validate a code snippet against safety guardrails.

License

MIT