Cursor IDE

by buga-luga

36 stars
Not rated
GitHub

About

Capable of controlling and pulling from Cursor IDE, powering development workflows.

Details

Author
buga-luga
Repository
Buga-luga/cursor-mcp
GitHub stars
36
License
MIT License
Categories
Productivity, Design, Developer Tools, AI, Frontend
Tags
#integration

- Real-time AI assistance in your development workflow
- Context-aware code suggestions and completions
- Seamless integration with Cursor IDE
- Windows automation for enhanced productivity

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:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Cursor IDE
    Command (node, npx, python, etc.) cmd
    Arguments
    • Argument 1 /c
    • Argument 2 mcp-cursor
    Environment
    • DEFAULT_WORKSPACE_PATH C:/Users/YourUsername/Documents/cursor-workspaces

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

To install Cursor for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install cursor-mcp-tool --client claude

1. Prerequisites
- Node.js v18 or higher
- Cursor IDE
- Windows 10 or higher

2. Installation


npm install -g mcp-cursor

git clone https://github.com/yourusername/cursor-mcp.git
cd cursor-mcp
npm install

3. Configuration
- Create a .env file in your project root:


mcp-cursor

npm start

1. Clone and install:

   git clone https://github.com/yourusername/cursor-mcp.git
cd cursor-mcp
npm install

2. Create environment config:

   cp .env.example .env

Edit .env and set your workspace path:
   DEFAULT_WORKSPACE_PATH=C:/Users/YourUsername/Documents/cursor-workspaces

3. Build and run:


The evals package loads an mcp client that then runs the index.ts file, so there is no need to rebuild between tests. You can load environment variables by prefixing the npx command. Full documentation can be found here.

bash
OPENAI_API_KEY=your-key npx mcp-eval src/evals/evals.ts src/tools/cursor-tools.ts
```

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "cursor ide": {
            "env": {
                "DEFAULT_WORKSPACE_PATH": "C:/Users/YourUsername/Documents/cursor-workspaces"
            },
            "args": [
                "/c",
                "mcp-cursor"
            ],
            "command": "cmd"
        }
    }
}

Linux

{
    "env": {
        "DEFAULT_WORKSPACE_PATH": "C:/Users/YourUsername/Documents/cursor-workspaces"
    },
    "args": [
        "/c",
        "mcp-cursor"
    ],
    "command": "cmd"
}

Macos

{
    "env": {
        "DEFAULT_WORKSPACE_PATH": "C:/Users/YourUsername/Documents/cursor-workspaces"
    },
    "args": [
        "/c",
        "mcp-cursor"
    ],
    "command": "cmd"
}

Windows

{
    "env": {
        "DEFAULT_WORKSPACE_PATH": "C:/Users/YourUsername/Documents/cursor-workspaces"
    },
    "args": [
        "/c",
        "mcp-cursor"
    ],
    "command": "cmd"
}

Cursor MCP - Claude Desktop Integration

smithery badge

A Model Context Protocol (MCP) implementation that enables seamless integration between Claude AI and desktop applications through Cursor IDE. This tool serves as a bridge between Claude's capabilities and desktop software, allowing for enhanced AI-powered development workflows.

<a href="https://glama.ai/mcp/servers/4fg1gxbcex">Cursor Server MCP server</a>

Quick Start (Windows)

Installing via Smithery

To install Cursor for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install cursor-mcp-tool --client claude

Installing Manually

1. Prerequisites - Node.js v18 or higher - Cursor IDE - Windows 10 or higher

2. Installation

   # Install globally
npm install -g mcp-cursor

# Or install locally
git clone https://github.com/yourusername/cursor-mcp.git
cd cursor-mcp
npm install

3. Configuration
- Create a .env file in your project root:

     # Windows path example
DEFAULT_WORKSPACE_PATH=C:/Users/YourUsername/Documents/cursor-workspaces

4. Add to Claude's MCP Configuration
Add the following to your Claude configuration:

   {
"name": "cursor",
"type": "mcp",
"config": {
"server": "https://glama.ai/mcp/servers/4fg1gxbcex",
"capabilities": ["cursor_control", "window_management"]
}
}

5. Start the Server

   # If installed globally
mcp-cursor

# If installed locally
npm start

Features

- Real-time AI assistance in your development workflow - Context-aware code suggestions and completions - Seamless integration with Cursor IDE - Windows automation for enhanced productivity

Detailed Setup

Local Development Setup

1. Clone and install:
   git clone https://github.com/yourusername/cursor-mcp.git
   cd cursor-mcp
   npm install
   

2. Create environment config:

   cp .env.example .env

Edit .env and set your workspace path:
   DEFAULT_WORKSPACE_PATH=C:/Users/YourUsername/Documents/cursor-workspaces

3. Build and run:

   # Development mode with hot reload
npm run dev

# Production mode
npm run build
npm start

Troubleshooting

1. Window Detection Issues
- Ensure Cursor IDE is running
- Try restarting the MCP server
- Check if your workspace path is correct

2. Permission Issues
- Run terminal as administrator for first-time setup
- Ensure proper file permissions in workspace directory

3. Node Version Issues
- Use nvm to switch to Node.js v18 or higher:

     nvm install 18
nvm use 18

Project Structure

cursor-mcp/
├── src/           # Source code
│   ├── services/  # Core services
│   ├── handlers/  # Event handlers
│   └── types/     # TypeScript definitions
├── build/         # Compiled JavaScript
└── .env          # Environment configuration

Scripts

- npm run build - Compile TypeScript - npm start - Run production server - npm run dev - Start development server with hot-reload

Contributing

1. Fork the repository 2. Create feature branch (git checkout -b feature/amazing-feature) 3. Commit changes (git commit -m 'Add feature') 4. Push to branch (git push origin feature/amazing-feature) 5. Open a Pull Request

License

MIT License - see LICENSE file for details.

Running evals

The evals package loads an mcp client that then runs the index.ts file, so there is no need to rebuild between tests. You can load environment variables by prefixing the npx command. Full documentation can be found here.

OPENAI_API_KEY=your-key  npx mcp-eval src/evals/evals.ts src/tools/cursor-tools.ts

Support

For support: - Open an issue in the GitHub repository - Join our Discord community - Check the FAQ
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.