Cursor MCP 安装器

<div align="center">

<pre style="text-align: center;">

---

/ /\ /\ // \ //\ //\ / \ / _
/ / / / \ / //\ \ // // // / \ / / / /)/ / /\ _/ / _ _\ / _// _ / //\ / // / _/ _// _/_/_// _// /__//

---

_ /\ \ / /_ /\ / / / / //\ / // / /\ \ / ///\ / / / / /\ / //
// // /\ / \ \ / / / _ / // //// _ \ _/_\ / _/ / _/ _/_/_/_// _/

+---------------------------------------------+ | 🚀 CURSOR MCP 安装器 🚀 | | ✨ 轻松神奇地安装 MCP 服务器 ✨ | +---------------------------------------------+ </pre>

<p>一个模型上下文协议 (MCP) 服务器，用于在 Cursor IDE 中安装和配置其他 MCP 服务器。</p>

<a href="https://www.linkedin.com/in/digitalmarketingstrategyexpert/"> <img src="https://img.shields.io/badge/LinkedIn-Matthew_Cage-blue?style=flat&logo=linkedin" alt="LinkedIn"/> </a> </div>

📢 现在可在 NPM 上使用！ 使用简单的 npm install -g cursor-mcp-installer-free 命令安装，或直接使用 npx cursor-mcp-installer-free 或 uvx cursor-mcp-installer-free！

🔄 最新更新 (v0.1.3)： 改进了所有 MCP 服务器安装的路径处理，更好地检测 OpenAPI 模式，以及在本地目录中更强大的服务器发现。感谢 @ItzAmirreza 提交了初始安装路径处理问题。有关详细信息，请参阅 CHANGELOG.md。

快速入门指南

步骤 1：添加到 Cursor 配置

选择以下方法之一将 MCP 安装器添加到您的 Cursor 配置：

使用 npx（最简单 - 无需安装）

将其添加到您的 ~/.cursor/mcp.json 文件（如果不存在则创建它）：

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

使用 npm（全局安装）

npm install -g cursor-mcp-installer-free@0.1.3

然后添加到您的 ~/.cursor/mcp.json：

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

步骤 2：重启 Cursor

关闭并重新打开 Cursor 以应用配置更改。

步骤 3：使用 Claude 安装服务器

要求 Claude 为您安装任何 MCP 服务器：

安装 web search MCP 服务器

或者

安装用于 OpenAPI 模式探索的 MCP 服务器，使用 my-schema.yaml

步骤 4：安装后您将看到的内容

正确安装并重启 Cursor 后，您将在使用 Claude 时在侧边栏中看到 MCP 安装器：

<img src="docs/installtion-success-cursor-screenshot.png" alt="MCP Installer Interface" width="500"/>

MCP 安装器提供三个主要工具：

• install_repo_mcp_server: 从 npm 包或存储库安装 MCP 服务器
• install_local_mcp_server: 从本地目录安装 MCP 服务器
• add_to_cursor_config: 添加自定义 MCP 服务器配置

特性

• 从 npm 包安装 MCP 服务器
• 从本地目录安装 MCP 服务器
• 配置 Cursor 的 MCP 服务器
• 添加自定义 MCP 服务器配置

前提条件

在使用此工具之前，您需要安装：

• Node.js（用于 npm 包）
• Cursor IDE

安装

有几种方法可以安装和使用 Cursor MCP 安装器：

1. 使用 npm（推荐）

npm install -g cursor-mcp-installer-free@0.1.3

安装后，将其添加到您的 Cursor MCP 配置文件：

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

2. 使用 npx（无需安装）

您可以使用 npx 运行该包，而无需全局安装它：

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

3. 直接从 GitHub

克隆存储库并在本地构建它：

# 克隆存储库
git clone https://github.com/matthewdcage/cursor-mcp-installer.git
cd cursor-mcp-installer

# 安装依赖项并构建
npm install
npm run build

然后配置 Cursor 以使用您的本地安装：

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

将 /path/to/cursor-mcp-installer 替换为您克隆存储库的实际路径。

Cursor MCP 配置文件在哪里？

Cursor MCP 配置文件位于：

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

如果该文件不存在，您可以创建它，内容来自上述任何安装方法。

v0.1.3 中的路径处理改进

版本 0.1.3 引入了 MCP 服务器安装的路径处理的重大改进：

增强的路径解析

• 正确规范化相对路径和绝对路径
• 处理带有空格和特殊字符的路径
• 确保跨不同操作系统的路径格式一致

更好的模式检测

• 现在扫描所有参数以查找模式文件，而不仅仅是第一个
• 支持更多模式文件扩展名（.yaml、.yml、.json、.openapi）
• 在传递给服务器之前，正确规范化模式文件路径

改进的服务器发现

• 添加了对本地目录中常见服务器入口点的检测
• 增强了对基于 Python 的 MCP 服务器的支持
• 改进了路径相关问题的错误报告

这些改进使 MCP 安装器对于所有类型的服务器安装都更加强大，尤其是在处理自定义文件路径、OpenAPI 模式和本地目录安装时。

用法

安装后，您可以使用 Claude 或 Cursor 与 MCP 安装器进行交互。以下是一些示例提示：

将 npm 包安装为 MCP 服务器

安装名为 mcp-server-fetch 的 MCP 服务器

使用参数安装

安装 @modelcontextprotocol/server-filesystem 包作为 MCP 服务器。使用 ['/home/user/documents'] 作为参数

安装本地 MCP 服务器

在 /home/user/projects/my-mcp-server 安装 MCP 服务器

使用环境变量安装