open-index/open-npm huggingface dataset:
npm package: @recursorsdk/mcp
Description: Recursor MCP Server - Node.js implementation
Author: Recursor Team
Latest version: 1.0.1

# 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

```bash
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`:

```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