home / mcp / cursor mcp server

Cursor MCP Server

Provides real-time AI-assisted integration between Claude and Cursor IDE for desktop development workflows.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "buga-luga-cursor-mcp": {
      "url": "https://glama.ai/mcp/servers/4fg1gxbcex",
      "headers": {
        "DEFAULT_WORKSPACE_PATH": "C:/Users/YourUsername/Documents/cursor-workspaces"
      }
    }
  }
}

Cursor MCP creates a bridge between Claude AI and your desktop tooling, enabling real-time AI-assisted development workflows within Cursor IDE. It connects Claude’s capabilities to your local workspace so you can get context-aware suggestions, window management, and automation while you code.

How to use

To use the Cursor MCP server, you connect your Claude MCP client to the provided server endpoint and enable the cursor capabilities you need. Once connected, Claude can help you control the Cursor workspace, manage windows, and provide context-aware guidance as you develop.

How to install

Prerequisites include Node.js v18 or higher and Cursor IDE installed on Windows 10 or newer. Follow the steps below to install and run the Cursor MCP server.

# 1) Prerequisites
# - Node.js v18+
# - Cursor IDE
# - Windows 10+

# 2) Install globally (recommended for system-wide usage)
`npm install -g mcp-cursor`

# 3) Alternative: install locally (within your project)
`git clone https://github.com/yourusername/cursor-mcp.git`
`cd cursor-mcp`
`npm install

Create a local environment file in your project to specify your workspace path, for example in Windows style.

# Example .env in project root
DEFAULT_WORKSPACE_PATH=C:/Users/YourUsername/Documents/cursor-workspaces

Add the MCP configuration for Claude to your client so Claude knows how to reach Cursor MCP and what capabilities to enable.

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

Start the MCP server. Depending on how you installed it, use the appropriate command.

# If installed globally
`mcp-cursor`

# If installed locally
`npm start

Additional setup and configuration

Local development setup mirrors the installation steps above, including creating an environment configuration and starting in development or production modes.

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

2) Create and customize environment settings.

cp .env.example .env`

# Then edit .env to set your workspace path
`DEFAULT_WORKSPACE_PATH=C:/Users/YourUsername/Documents/cursor-workspaces

3) Build and run in production or development mode.

# Development mode with hot reload
`npm run dev`

# Production mode
`npm run build`
`npm start

Troubleshooting

If you encounter issues, try the following steps to resolve common problems.

Window detection issues: make sure Cursor IDE is running, restart the MCP server, and verify your workspace path is correct.

Permission issues: run your terminal as administrator for the initial setup, and verify file permissions in the workspace directory.

Node version issues: use a Node version manager to ensure you are on v18 or higher.

nvm install 18`
`nvm use 18

Project structure

A typical project layout looks like this, with source, builds, and environment configuration.

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

Scripts

Core npm scripts include building, starting, and developing with hot reloading.

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

Notes on contribution and licensing

If you contribute, follow standard workflow practices for forking, branching, committing, and submitting pull requests.

This project is released under the MIT License.