Cursor MCP - Claude Desktop Integration

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.

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 (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:

• Open an issue in the GitHub repository
• Join our Discord community
• Check the FAQ