___         __  __    ___  __            ___   ___ 
  / __\/\ /\  /__\/ _\  /___\/__\  /\/\    / __\ / _ \
 / /  / / \ \/ \//\ \  //  // \// /    \  / /   / /_)/
/ /___\ \_/ / _  \_\ \/ \_// _  \/ /\/\ \/ /___/ ___/ 
\____/ \___/\/ \_/\__/\___/\/ \_/\/    \/\____/\/     
                                                      
  _____    __  __  _____  _      __    __    __  __   
  \_   \/\ \ \/ _\/__   \/_\    / /   / /   /__\/__\  
   / /\/  \/ /\ \   / /\//_\\  / /   / /   /_\ / \//  
/\/ /_/ /\  / _\ \ / / /  _  \/ /___/ /___//__/ _  \  
\____/\_\ \/  \__/ \/  \_/ \_/\____/\____/\__/\/ \_/  

+---------------------------------------------+
| 🚀 CURSOR MCP INSTALLER 🚀                 |
| ✨ Magically install MCP servers with ease ✨ |
+---------------------------------------------+

A Model Context Protocol (MCP) server for installing and configuring other MCP servers within Cursor IDE.

📢 NOW AVAILABLE ON NPM! Install with a simple npm install -g cursor-mcp-installer-free command or use directly with npx cursor-mcp-installer-free or uvx cursor-mcp-installer-free!

🔄 Latest Updates (v0.1.3): Improved path handling for all MCP server installations, better OpenAPI schema detection, and more robust server discovery in local directories. Thanks to @ItzAmirreza for submitting the initial installation path handling issue. See CHANGELOG.md for details.

Choose one of these methods to add the MCP Installer to your Cursor configuration:

Add this to your ~/.cursor/mcp.json file (create it if it doesn't exist):

{
  "mcpServers": {
    "MCP Installer": {
      "command": "npx",
      "type": "stdio",
      "args": [
        "[email protected]",
        "index.mjs"
      ]
    }
  }
}

npm install -g [email protected]

Then add to your ~/.cursor/mcp.json:

{
  "mcpServers": {
    "MCP Installer": {
      "command": "cursor-mcp-installer-free",
      "type": "stdio",
      "args": [
        "index.mjs"
      ]
    }
  }
}

Close and reopen Cursor to apply the configuration changes.

Ask Claude to install any MCP server for you:

Install the web search MCP server

or

Install the MCP server for OpenAPI schema exploration with my-schema.yaml

Once properly installed and Cursor is restarted, you'll see the MCP Installer available in the sidebar when using Claude:

The MCP Installer provides three main tools:

• install_repo_mcp_server: Install MCP servers from npm packages or repositories
• install_local_mcp_server: Install MCP servers from local directories
• add_to_cursor_config: Add custom MCP server configurations

• Install MCP servers from npm packages
• Install MCP servers from local directories
• Configure MCP servers for Cursor
• Add custom MCP server configurations

Before using this tool, you need to have installed:

• Node.js (for npm packages)
• Cursor IDE

There are several ways to install and use the Cursor MCP Installer:

npm install -g [email protected]

After installation, add it to your Cursor MCP configuration file:

{
  "mcpServers": {
    "MCP Installer": {
      "command": "cursor-mcp-installer-free",
      "type": "stdio",
      "args": [
        "index.mjs"
      ]
    }
  }
}

You can use npx to run the package without installing it globally:

{
  "mcpServers": {
    "MCP Installer": {
      "command": "npx",
      "type": "stdio",
      "args": [
        "[email protected]",
        "index.mjs"
      ]
    }
  }
}

Clone the repository and build it locally:

# Clone the repository
git clone https://github.com/matthewdcage/cursor-mcp-installer.git
cd cursor-mcp-installer

# Install dependencies and build
npm install
npm run build

Then configure Cursor to use your local installation:

{
  "mcpServers": {
    "MCP Installer": {
      "command": "node",
      "type": "stdio",
      "args": [
        "/path/to/cursor-mcp-installer/lib/index.mjs"
      ]
    }
  }
}

Replace /path/to/cursor-mcp-installer with the actual path where you've cloned the repository.

The Cursor MCP configuration file is located at:

• macOS/Linux: ~/.cursor/mcp.json
• Windows: %USERPROFILE%\.cursor\mcp.json

If the file doesn't exist, you can create it with the content from any of the installation methods above.

Version 0.1.3 introduces significant improvements to path handling for MCP server installations:

• Properly normalizes both relative and absolute paths
• Handles paths with spaces and special characters
• Ensures consistent path formatting across different operating systems

• Now scans all arguments for schema files, not just the first one
• Supports more schema file extensions (.yaml, .yml, .json, .openapi)
• Properly normalizes schema file paths before passing to servers

• Added detection of common server entry points in local directories
• Enhanced support for Python-based MCP servers
• Better error reporting for path-related issues

These improvements make the MCP Installer more robust for all types of server installations, especially when dealing with custom file paths, OpenAPI schemas, and local directory installations.

Once installed, you can use Claude or Cursor to interact with the MCP Installer. Here are some example prompts:

Install the MCP server named mcp-server-fetch

Install the @modelcontextprotocol/server-filesystem package as an MCP server. Use ['/home/user/documents'] for the arguments

Install the MCP server at /home/user/projects/my-mcp-server