Content
# Cursor MCP - Claude Desktop Integration
[](https://smithery.ai/server/cursor-mcp-tool)
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"><img width="380" height="200" src="https://glama.ai/mcp/servers/4fg1gxbcex/badge" alt="Cursor Server MCP server" /></a>
## Quick Start (Windows)
### Installing via Smithery
To install Cursor for Claude Desktop automatically via [Smithery](https://smithery.ai/server/cursor-mcp-tool):
```bash
npx -y @smithery/cli install cursor-mcp-tool --client claude
```
### Installing Manually
1. **Prerequisites**
- [Node.js](https://nodejs.org/) v18 or higher
- [Cursor IDE](https://cursor.sh/)
- Windows 10 or higher
2. **Installation**
```bash
# 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:
```bash
# 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:
```json
{
"name": "cursor",
"type": "mcp",
"config": {
"server": "https://glama.ai/mcp/servers/4fg1gxbcex",
"capabilities": ["cursor_control", "window_management"]
}
}
```
5. **Start the Server**
```bash
# 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:
```bash
git clone https://github.com/yourusername/cursor-mcp.git
cd cursor-mcp
npm install
```
2. Create environment config:
```bash
cp .env.example .env
```
Edit `.env` and set your workspace path:
```bash
DEFAULT_WORKSPACE_PATH=C:/Users/YourUsername/Documents/cursor-workspaces
```
3. Build and run:
```bash
# 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:
```bash
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:
- Open an issue in the GitHub repository
- Join our [Discord community](https://discord.gg/yourcommunity)
- Check the [FAQ](https://github.com/yourusername/cursor-mcp/wiki/FAQ)
