Skip to content

MCP server integration for Cursor editor, enabling AI-assisted development within the IDE

License

Notifications You must be signed in to change notification settings

console-1/cursor-mcp

 
 

Repository files navigation

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.

Cursor Server MCP server

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

  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 (macOS Specific)

  1. Permission Issues

    • Enable Accessibility permissions in System Settings
    • Grant Full Disk Access to Terminal
    • Ensure Automation permissions for Cursor
  2. Window Management

    • Keep Cursor in foreground during operations
    • Ensure stable network connection for MCP protocol
  3. Version Requirements

    • macOS 11 (Big Sur) or newer
    • Node.js 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.

Support

For support:

About

MCP server integration for Cursor editor, enabling AI-assisted development within the IDE

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 93.0%
  • JavaScript 4.7%
  • Dockerfile 2.3%