Cursor MCP Installer

📢 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!

Quick Start Guide

Step 1: Add to Cursor Configuration

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

Using npx (Easiest - No Installation Required)

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

Using uvx (Python Users)

Using npm (Global Installation)

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

Step 2: Restart Cursor

Close and reopen Cursor to apply the configuration changes.

Step 3: Use Claude to Install Servers

Ask Claude to install any MCP server for you:

or

Features

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

Prerequisites

Before using this tool, you need to have installed:

• Node.js (for npm packages)
• Cursor IDE
• uv (optional, for Python packages)

Installation

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

1. Using npm (Recommended)

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

2. Using npx (No Installation Required)

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

3. Using uv/uvx (Python Package Manager)

If you prefer using Python's uv package manager:

4. Direct from GitHub

Clone the repository and build it locally:

Then configure Cursor to use your local installation:

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

Where is the Cursor MCP Configuration File?

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.

Usage

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

Install an npm package as an MCP server

Install with arguments

Install a local MCP server

Install with environment variables

Add a custom MCP server configuration

Supported MCP Servers

Here are some popular MCP servers you can install:

• @modelcontextprotocol/server-fetch - Web access
• @modelcontextprotocol/server-filesystem - File system access
• @modelcontextprotocol/server-github - GitHub access
• mcp-openapi-schema - OpenAPI Schema Explorer

Special MCP Server Handling

The installer has enhanced handling for certain types of MCP servers:

OpenAPI Schema Servers

For the mcp-openapi-schema server or repositories that provide OpenAPI schema tools, the installer will:

1. Detect schema files passed as arguments (.yaml, .json, .yml)
2. Configure Cursor to run the server correctly with the schema file

Example:

Python MCP Servers

For Python-based MCP servers like X-MCP, the installer will:

1. Detect Python-based repositories and packages
2. Configure them to run as Python modules using python3 -m module_name.server
3. Set up the proper environment variables for configuration

Example:

The X-MCP Twitter server will require proper Twitter API credentials to be added to the configuration after installation.

Git Repositories

For MCP servers hosted in Git repositories:

1. The installer will clone the repository
2. Install dependencies
3. Configure it to run with the appropriate entry point
4. Pass any provided schema files or arguments correctly

Example:

Troubleshooting

Common Issues

Node.js is not installed

Solution: Install Node.js from nodejs.org

Python uv is not installed

Solution: Install uv following the instructions at docs.astral.sh/uv

Path does not exist

Solution: Check that the path to your local MCP server is correct

Package not found in npm registry

Solution: Check that the package name is correct and exists in the npm registry. You can also try installing directly from a Git repository using https://github.com/username/repo.git as the package name.

Permission issues when writing to mcp.json

Solution: Make sure you have write permissions to the Cursor configuration directory.

Contributing

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

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Development

Building the Package

Publishing to npm

Make sure you have the appropriate npm credentials and are logged in:

Then publish the package:

Alternatively, you can publish manually with:

License

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

Acknowledgments

• Based on the MCP Installer by Anais Betts
• Built with the Model Context Protocol SDK