Awesome Cursor MPC
Example of an MCP server with custom tools that can be called directly from cursor
What is Awesome Cursor MPC?
Awesome Cursor MPC is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to example of an mcp server with custom tools that can be called directly from cursor
Example of an MCP server with custom tools that can be called directly from cursor
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Example of an MCP server with custom tools that can be calle
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx awesome-cursor-mpcConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Awesome Cursor MPC
Awesome Cursor MPC Server is a reference implementation and developer starter kit for building custom MCP servers that integrate directly with the Cursor AI code editor. It demonstrates how to define MCP tools — including a Code Architect for generating architectural plans and a Screenshot Buddy for UI design analysis — and wire them into Cursor's composer agent workflow. Developers use this project as a learning template and foundation for building their own Cursor-compatible AI coding extensions.
Prerequisites
- Node.js 18 or higher and npm installed
- Cursor AI editor installed (cursor.sh)
- An OpenAI API key (stored in src/env/keys.ts) for the AI-powered tools
- Git for cloning the repository
Clone the repository
Clone the awesome-cursor-mpc-server repository from GitHub to your local machine.
git clone https://github.com/kleneway/awesome-cursor-mpc-server.git
cd awesome-cursor-mpc-serverInstall dependencies
Install the Node.js dependencies required by the MCP server.
npm installAdd your OpenAI API key
Create the src/env/keys.ts file and add your OpenAI API key. This is used by the Code Architect and other AI-powered tools in the server.
// src/env/keys.ts
export const OPENAI_API_KEY = "your_openai_api_key_here";Build the MCP server
Compile the TypeScript source to JavaScript so it can be run by Node.js.
npm run buildConfigure Cursor to use this MCP server
Add the MCP server to Cursor's MCP settings, pointing to the built index.js file. In Cursor, open Settings > MCP and add a new server entry.
{
"mcpServers": {
"awesome-cursor-mpc": {
"command": "node",
"args": ["/absolute/path/to/awesome-cursor-mpc-server/dist/index.js"]
}
}
}Use the custom tools in Cursor's composer
Open Cursor's composer (Cmd+I or Ctrl+I) and invoke the custom tools. The Code Architect tool generates architecture plans; Screenshot Buddy analyzes UI images; Code Review reviews git diffs.
Awesome Cursor MPC Examples
Client configuration (Cursor MCP settings)
Cursor MCP settings entry for the Awesome Cursor MPC Server.
{
"mcpServers": {
"awesome-cursor-mpc": {
"command": "node",
"args": ["/absolute/path/to/awesome-cursor-mpc-server/dist/index.js"]
}
}
}Prompts to try
Example prompts that work well in Cursor's composer once the Awesome Cursor MPC Server is connected.
- "Use the Code Architect tool to plan the implementation of a user authentication system"
- "Analyze this UI screenshot and suggest how to implement it in React"
- "Review the current git diff and highlight any potential bugs"
- "Help me design the folder structure for a new Next.js e-commerce app"Troubleshooting Awesome Cursor MPC
OpenAI API calls fail with authentication error
Verify that src/env/keys.ts exports the correct OPENAI_API_KEY value and that the key is active in your OpenAI account. Remember to rebuild with 'npm run build' after editing the file.
MCP tools do not appear in Cursor's composer
Ensure the absolute path to dist/index.js is correct in Cursor's MCP settings. Restart Cursor after making configuration changes. Verify the build succeeded by checking that dist/index.js exists.
TypeScript build errors during npm run build
Run 'npm install' to ensure all TypeScript dependencies are present. Check that you are using Node.js 18 or higher. If type errors occur in src/env/keys.ts, verify the file exports the OPENAI_API_KEY as shown in the setup step.
Frequently Asked Questions about Awesome Cursor MPC
What is Awesome Cursor MPC?
Awesome Cursor MPC is a Model Context Protocol (MCP) server that example of an mcp server with custom tools that can be called directly from cursor It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Awesome Cursor MPC?
Follow the installation instructions on the Awesome Cursor MPC GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Awesome Cursor MPC?
Awesome Cursor MPC works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Awesome Cursor MPC free to use?
Yes, Awesome Cursor MPC is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Awesome Cursor MPC Alternatives — Similar Developer Tools Servers
Looking for alternatives to Awesome Cursor MPC? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Awesome Cursor MPC in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Awesome Cursor MPC?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.