https://github.com/matthewdcage/cursor-mcp-installer

Installs MCPs in cursor for you, give it a git URL and let it rip
https://github.com/matthewdcage/cursor-mcp-installer

Last synced: 3 months ago
JSON representation

Installs MCPs in cursor for you, give it a git URL and let it rip

Host: GitHub
URL: https://github.com/matthewdcage/cursor-mcp-installer
Owner: matthewdcage
License: mit
Created: 2025-03-20T03:05:04.000Z (3 months ago)
Default Branch: main
Last Pushed: 2025-03-29T03:57:44.000Z (3 months ago)
Last Synced: 2025-03-29T04:26:33.898Z (3 months ago)
Language: JavaScript
Size: 60.5 KB
Stars: 19
Watchers: 1
Forks: 2
Open Issues: 1
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE

Awesome Lists containing this project

mcp-index - Cursor MCP Installer - Facilitates the installation and configuration of MCP servers directly within the Cursor IDE, streamlining setup and enhancing the development workflow. (Task and Project Management)

README

# Cursor MCP Installer

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

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

+---------------------------------------------+
| 🚀 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.

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![npm version](https://img.shields.io/npm/v/cursor-mcp-installer-free.svg)](https://www.npmjs.com/package/cursor-mcp-installer-free)
[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-brightgreen.svg)](https://github.com/anthropic-labs/model-context-protocol)
[![Cursor IDE](https://img.shields.io/badge/Cursor-IDE-blue.svg)](https://cursor.sh)
[![npm downloads](https://img.shields.io/npm/dt/cursor-mcp-installer-free.svg)](https://www.npmjs.com/package/cursor-mcp-installer-free)

> **📢 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](https://github.com/ItzAmirreza) for submitting the initial installation path handling issue. See [CHANGELOG.md](CHANGELOG.md) for details.

## 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):

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

#### Using npm (Global Installation)

```bash
npm install -g [email protected]
```

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

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

### 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:

```
Install the web search MCP server
```

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

### Step 4: What You'll See When Installed

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

MCP Installer Interface

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

## 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](https://nodejs.org/) (for npm packages)
- [Cursor IDE](https://cursor.sh/)

## Installation

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

### 1. Using npm (Recommended)

```bash
npm install -g [email protected]
```

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

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

### 2. Using npx (No Installation Required)

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

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

### 3. Direct from GitHub

Clone the repository and build it locally:

```bash
# 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:

```json
{
"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.

### 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.

## Path Handling Improvements in v0.1.3

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

### Enhanced Path Resolution
- Properly normalizes both relative and absolute paths
- Handles paths with spaces and special characters
- Ensures consistent path formatting across different operating systems

### Better Schema Detection
- 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

### Improved Server Discovery
- 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.

## 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 the MCP server named mcp-server-fetch
```

### Install with arguments

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

### Install a local MCP server

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

### Install with environment variables

```

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/matthewdcage/cursor-mcp-installer

Awesome Lists containing this project

README