Awesome Cursor Mpc Server

🚀 AI Development Assistant MCP Server

This is your AI-driven development toolkit, a Model Context Protocol (MCP) server designed for Cursor! This project offers intelligent coding assistance through custom AI tools. Note that this is primarily a tutorial demonstration, not a production-ready tool.

✨ Features

🎨 Code Architect

Invoke advanced inference 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.

🚀 Quick Start

1. Environment Setup

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

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

⚠️ Important Note

Storing API keys directly in the source code is not recommended for production environments. This is for local development and learning purposes only. You can also set environment variables directly in the Cursor MCP interface.

2. Installation

npm install
# Or
yarn install

3. Build the Server

npm run build

4. Add to Cursor

This project is designed to serve 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

💡 Usage Tip

You may need to use the full path to the project build file.

After adding the server, you should see a list of tools under "Available Tools". If not, try clicking the refresh button in the top-right corner of the MCP server section.

For more details on MCP settings, refer to the Cursor MCP documentation.

💻 Usage Examples

Basic Usage

After configuration, you can use these tools directly in Cursor's Composer. The AI will automatically suggest relevant tools, or you can explicitly request a tool by name or description.

For example, try typing the following in the 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.

💡 Usage Tip

You can add instructions in the .cursorrules file to specify how to use tools in certain situations, and the agent will use them automatically.

📚 Documentation

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           # Entry point

🤝 Contribution

Contributions are welcome! Feel free to submit a Pull Request.

📄 License

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

🐛 Issues and Support

Found a bug or need help? When opening an issue, please provide the following information:

1. What you were trying to accomplish.
2. What happened.
3. Steps to reproduce.
4. Environment details.

I must be honest, this is a tutorial demonstration, not a production-ready tool, so I may not fix issues. But feel free to fork and develop it on your own!

Made by developers for developers, ❤️