Awesome Cursor

by kleneway

281 633 downloads Not rated yet MIT

GitHub

About

Built for Cursor, integrates screenshot capture, web page structure analysis, and code review capabilities for automated UI testing, web scraping, and code quality checks.

Details

Repository: kleneway/awesome-cursor-mpc-server
License: MIT

Explore

- Code Architect – generates plans and instructions using advanced reasoning LLMs
- Screenshot Buddy – takes UI design screenshots and uses them with the composer agent
- Code Review – uses git diffs to trigger code reviews
- Simple environment setup with API keys in src/env/keys.ts
- Integrates directly into Cursor’s composer interface

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Awesome Cursor

Command (node, npx, python, etc.) node
Arguments
- Argument 1 /path/to/your/project/dist/index.js
Environment
- OPENAI_API_KEY your_key_here
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "awesome cursor": {
            "env": {
                "OPENAI_API_KEY": "your_key_here"
            },
            "args": [
                "/path/to/your/project/dist/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "awesome cursor": {
            "env": {
                "OPENAI_API_KEY": "your_key_here"
            },
            "args": [
                "/path/to/your/project/dist/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "awesome cursor": {
            "env": {
                "OPENAI_API_KEY": "your_key_here"
            },
            "args": [
                "/path/to/your/project/dist/index.js"
            ],
            "command": "node"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "awesome cursor": {
            "env": {
                "OPENAI_API_KEY": "your_key_here"
            },
            "args": [
                "/path/to/your/project/dist/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "awesome cursor": {
            "env": {
                "OPENAI_API_KEY": "your_key_here"
            },
            "args": [
                "/path/to/your/project/dist/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "awesome cursor": {
            "env": {
                "OPENAI_API_KEY": "your_key_here"
            },
            "args": [
                "/path/to/your/project/dist/index.js"
            ],
            "command": "node"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "awesome cursor": {
            "env": {
                "OPENAI_API_KEY": "your_key_here"
            },
            "args": [
                "/path/to/your/project/dist/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "awesome cursor": {
            "env": {
                "OPENAI_API_KEY": "your_key_here"
            },
            "args": [
                "/path/to/your/project/dist/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "awesome cursor": {
            "env": {
                "OPENAI_API_KEY": "your_key_here"
            },
            "args": [
                "/path/to/your/project/dist/index.js"
            ],
            "command": "node"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "awesome cursor": {
            "env": {
                "OPENAI_API_KEY": "your_key_here"
            },
            "args": [
                "/path/to/your/project/dist/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "awesome cursor": {
            "env": {
                "OPENAI_API_KEY": "your_key_here"
            },
            "args": [
                "/path/to/your/project/dist/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "awesome cursor": {
            "env": {
                "OPENAI_API_KEY": "your_key_here"
            },
            "args": [
                "/path/to/your/project/dist/index.js"
            ],
            "command": "node"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "awesome cursor": {
            "env": {
                "OPENAI_API_KEY": "your_key_here"
            },
            "args": [
                "/path/to/your/project/dist/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "awesome cursor": {
            "env": {
                "OPENAI_API_KEY": "your_key_here"
            },
            "args": [
                "/path/to/your/project/dist/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "awesome cursor": {
            "env": {
                "OPENAI_API_KEY": "your_key_here"
            },
            "args": [
                "/path/to/your/project/dist/index.js"
            ],
            "command": "node"
        }
    }
}

From the repository

First, you'll need to set up your environment variables. Create a file at src/env/keys.ts:

export const OPENAI_API_KEY = "your_key_here";
// Add any other keys you need

> ⚠️ Security Note: Storing API keys directly in source code is not recommended for production environments. This is only for local development and learning purposes. You can set the env var inline in the Cursor MCP interface as well.

```bash
npm install

`Code Architect`

Call advanced reasoning LLMs to generate plans and instructions for coding agents.

`Screenshot Buddy`

Take UI design screenshots and use them with the composer agent.

`Code Review`

Use git diffs to trigger code reviews.

Once configured, you can use these tools directly in Cursor's Composer. The AI will automatically suggest using relevant tools, or you can explicitly request them by name or description.

For example, try typing in Composer:

- "Review this code for best practices"
- "Help me architect a new feature"
- "Analyze this UI screenshot"

The agent will ask for your approval before making any tool calls.

> 📘 Pro Tip: You can update your .cursorrules file with instructions on how to use the tools for certain scenarios, and the agent will use the tools automatically.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "awesome cursor": {
            "env": {
                "OPENAI_API_KEY": "your_key_here"
            },
            "args": [
                "/path/to/your/project/dist/index.js"
            ],
            "command": "node"
        }
    }
}

Linux

{
    "env": {
        "OPENAI_API_KEY": "your_key_here"
    },
    "args": [
        "/path/to/your/project/dist/index.js"
    ],
    "command": "node"
}

Macos

{
    "env": {
        "OPENAI_API_KEY": "your_key_here"
    },
    "args": [
        "/path/to/your/project/dist/index.js"
    ],
    "command": "node"
}

Windows

{
    "env": {
        "OPENAI_API_KEY": "your_key_here"
    },
    "args": [
        "/path/to/your/project/dist/index.js"
    ],
    "command": "node"
}

or

yarn install

3. Build the Server

bash
npm run build

4. Adding to Cursor This project is designed to be used as an MCP server in Cursor. Here's how to set it up: 1. Open Cursor 2. Go to Cursor Settings > Features > MCP 3. Click + Add New MCP Server 4. Fill out the form: - Name: AI Development Assistant - Type: stdio - Command: node /path/to/your/project/dist/index.js > 📘 Pro Tip: You might need to use the full path to your project's built index.js file. After adding the server, you should see your tools listed under "Available Tools". If not, try clicking the refresh button in the top right corner of the MCP server section. For more details about MCP setup, check out the Cursor MCP Documentation. 🛠️ Using the Tools Once configured, you can use these tools directly in Cursor's Composer. The AI will automatically suggest using relevant tools, or you can explicitly request them by name or description. For example, try typing in Composer: - "Review this code for best practices" - "Help me architect a new feature" - "Analyze this UI screenshot" The agent will ask for your approval before making any tool calls. > 📘 Pro Tip: You can update your .cursorrules file with instructions on how to use the tools for certain scenarios, and the agent will use the tools automatically. 📁 Project Structure

src/
├── tools/
│ ├── architect.ts # Code structure generator
│ ├── screenshot.ts # Screenshot analysis tool
│ └── codeReview.ts # Code review tool
├── env/
│ └── keys.ts # Environment configuration (add your API keys here!)
└── index.ts # Main entry point
```

🤝 Contributing

Contributions welcome! Please feel free to submit a Pull Request.

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🐛 Issues & Support

Found a bug or need help? Open an issue with:

1. What you were trying to do
2. What happened instead
3. Steps to reproduce
4. Your environment details

---

I'll be honest though, this is a tutorial demo, and not a production-ready tool so I likely won't be fixing issues. But feel free to fork it and make it your own!

Made with ❤️ by developers, for developers

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Explore

Setting up with Highlight

From the repository

Code Architect

Screenshot Buddy

Code Review

Claude Desktop / Cursor

Linux

Macos

Windows

or

3. Build the Server

4. Adding to Cursor

🛠️ Using the Tools

📁 Project Structure

🤝 Contributing

📝 License

🐛 Issues & Support

More like this

Time

Sentry

Github

Git

`Code Architect`

`Screenshot Buddy`

`Code Review`