Cursor MCP Server

by Buga-luga

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

Support

For support:

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

Facilitates integration with the Cursor code editor by enabling real-time code indexing, analysis, and bi-directional communication with Claude, supporting concurrent sessions and automatic reconnection.

  1. Quick Start (Windows)
    1. Installing via Smithery
    2. Installing Manually
  2. Features
    1. Detailed Setup
      1. Local Development Setup
      2. Troubleshooting
    2. Project Structure
      1. Scripts
        1. Contributing
          1. License
            1. Support

              Related MCP Servers

              • -
                security
                A
                license
                -
                quality
                An AI-powered development toolkit for Cursor providing intelligent coding assistance through advanced reasoning, UI screenshot analysis, and code review tools.
                Last updated -
                1,261
                240
                TypeScript
                MIT License
              • -
                security
                F
                license
                -
                quality
                A code review tool for Cursor IDE that uses OpenAI's GPT models to provide intelligent code analysis and suggestions.
                Last updated -
                2
                Python
                • Linux
                • Apple
              • -
                security
                A
                license
                -
                quality
                A Cursor-compatible toolkit that provides intelligent coding assistance through custom AI tools for code architecture planning, screenshot analysis, code review, and file reading capabilities.
                Last updated -
                1,261
                2
                TypeScript
                MIT License
              • -
                security
                F
                license
                -
                quality
                An MCP server that provides detailed information about your development environment to the Cursor code editor, enabling more context-aware assistance.
                Last updated -
                1
                Python
                • Linux
                • Apple

              View all related MCP servers

              ID: 4fg1gxbcex