MCP Easy Installer

MCP Easy Installer

MCP easy installer 是一款功能强大的 MCP 服务，提供搜索、安装、配置、修复和卸载 MCP 服务的工具。

MCP 服务的安装与修复工具

MCP easy installer 是一款功能强大的工具，用于搜索、安装、配置、修复和卸载 MCP 服务（Model Context Protocol）。该工具面向开发者、非开发者和最终用户，无需具备技术专业知识即可轻松设置和维护 MCP 服务。开发者和系统集成商也可以用它加快工作流，并自动执行重复性任务。该工具简化了设置流程，自动修复问题，并确保 MCP 环境始终运行正常。 该工具会自动安装并更新多种应用所需的所有 JSON 配置文件，包括 Claude Desktop、Windsurf、Cursor、Roo Code、Cline、*GitHub Copilot 等。它可确保 AI 和开发者工具生态系统中的各项设置无缝集成且保持最新。

---

功能

• 搜索与发现： 查找可供安装的 MCP 服务。
• 自动安装： 快速从 GitHub 或本地来源安装 MCP 服务。
• 修复工具： 检测并修复常见的 MCP 服务问题。
• TypeScript 支持： 使用 TypeScript 构建，确保可靠性和可维护性。
• 全面的日志记录： 为每项操作提供清晰的日志。
• 跨平台： 支持 Windows、Linux 和 Mac。

---

重要安装说明

MCP easy intaller 不会使用 npx 安装 Node.js MCP 服务。
而是手动将所有 MCP 服务安装到以下目录：

• Windows：

  C:\Users\USERNAME\Documents\Flowvibe\MCP\
  

• Linux/Mac：

  /home/USERNAME/Documents/Flowvibe/MCP/
  

请将 USERNAME 替换为系统中的实际用户名。

---

VS Code - GitHub Copilot 集成说明

此工具不直接支持 VS Code 的 GitHub Copilot。

GitHub Copilot 以自己的方式实现 MCP，与其他实现有显著差异。由于这些差异，GitHub Copilot 不在此工具支持的应用范围内。

• 变通方案： 如果要更新 VS Code GitHub Copilot 的 MCP 服务连接，请安装 Claude Desktop，因为 GitHub Copilot 会连接到 Claude Desktop 的 MCP 服务。通过 MCP，这可以间接增强 GitHub Copilot 的功能。

---

Python 集成说明

MCP 的 Python 集成存在一些限制。

虽然此工具旨在为多个平台和语言提供无缝集成，但目前对 Python 的支持尚不完善，在某些情况下可能需要手动干预。由于 Python 环境、包管理器和项目结构各不相同，自动安装和配置并非在所有情况下都能达到最佳效果。

欢迎社区贡献：

• 如果遇到 Python 集成问题，请在 issues 区分享解决方案
• 可以考虑 Fork 此仓库，为 Python 环境实现专门的改进
• 非常欢迎提交改进 Python 支持的 Pull Request

我们的目标是通过协作开发和用户反馈改进 Python 集成。

---

安装

克隆仓库并安装依赖：

选项 1：使用 Git 安装

# Clone the repository
git clone https://github.com/onigetoc/mcp-easy-installer.git

# Navigate to the directory
cd mcp-easy-installer

# Install dependencies
npm install

# Build the project
npm run build

# Test tools
npm run test-tools

选项 2：下载并安装

1. 从 https://github.com/onigetoc/mcp-easy-installer 下载最新版本
2. 将文件解压到首选位置
3. 在解压后的目录中打开终端
4. 运行 npm install 安装依赖
5. 运行 npm run build，编译应用以供 MCP 客户端使用

---

配置

在设置文件中配置 MCP 服务（GitHub token 是可选的，用于搜索 MCP 服务：可避免触发速率限制）：

默认情况下，该工具会搜索 TypeScript（ts）、JavaScript（js）和 HTML 仓库。你可以自定义这些语言，或使用 --langcode 参数添加其他语言（例如 Python 'py' 或 Shell 'sh'）。例如，要同时搜索 Python 和 Shell 仓库，可将 "--langcode=ts,js,html,py,sh" 添加到下面的 args 列表中。为简化设置，建议省略 --langcode 参数，以使用默认值。

{
  "mcpServers": {
    "mcp-easy-installer": {
      "command": "node",
      "args": ["path-to\\mcp-easy-installer\\build\\index.js"],
      "env": {
        "GITHUB_TOKEN": "your_github_token"
      }
    }
  }
}

示例：配置所有受支持的语言

如果你想自定义搜索时使用的语言，以下是一个包含所有受支持语言代码的 args 数组示例。不加这一行时，默认使用 JavaScript、TypeScript 和 HTML：

"args": [
  "path-to\\mcp-easy-installer\\build\\index.js",
  "--langcode=ts,js,html,py,sh"
]

// this will also work
"--langcode=typescript,javascript,HTML,python,shell" // Your can add more according to the Github search filter

获取你的个人 GitHub Token，然后点击 Generate new token（你可能需要先登录或创建 GitHub 账号）。

---

示例语句

社区问题：集成 GitHub 搜索

我们正在考虑是否要在此工具中直接集成 GitHub 搜索功能。如果集成，GitHub API token 可以是可选的——不提供 token 时，GitHub 搜索功能将无法使用（或可能受到限制），但所有其他工具和功能仍会正常运行。

欢迎社区提供反馈： 你希望内置 GitHub 搜索功能吗？请在此仓库的 issues 或 discussions 板块分享你的想法和使用场景。

你可以使用自然语言命令，例如：

• Search for the fetch mcp server. (follow up prompt: install the third one) 可能适用于 Brave 或其他带有 GitHub 或 npmjs 链接的搜索工具。
• Search Github mcp server "wikipedia server"
• Install this mcp server: https://www.npmjs.com/package/@modelcontextprotocol/server-brave-search（NPMjs 或 Github 仓库 URL），或使用 Install
• Install this mcp server tavily-ai/tavily-mcp
• Install mcp server with a Brave Github link search result.
• Repair the brave mcp server.
• Update all installed mcp servers. 目前尚不可用
• Uninstall Brave 可以正常工作，即使名称是 "server-brave-search"，也能找到它。

注意：根据大模型和工具函数的不同，使用以下两个词可能更容易触发 MCP：Install、repair、fix、search mcp servers.

---

平台测试

此工具主要在 Windows 上开发和测试，以解决 NPX 安装问题。虽然它旨在跨平台运行，但我们目前无法在所有操作系统上进行充分测试。

Mac 和 Linux 测试： 我们需要 Mac 和 Linux 用户提供反馈，以确保工具在所有平台上都兼容。如果你在 macOS 或 Linux 发行版上使用此工具：

• 请在 GitHub Issues 中报告遇到的问题
• 请注明操作系统版本和环境详情
• 欢迎提出针对特定平台的改进建议
• 如果你具备相关专业知识，请考虑贡献针对特定平台的修复

你的反馈对于让此工具在所有操作系统上都能无缝运行至关重要。

使用大模型优化 MCP 服务

通过对各种 MCP 服务进行大量测试，我们发现了一种让大模型与 MCP 服务交互的最佳方式，小型模型使用函数调用时也适用。以下是建议添加到 MCP 客户端上下文中的内容，可获得更好的效果：

Every time you use a MCP server (Model Context Protocol), you must give the complete information. If, for example, you are asked to do a search on anything (YouTube, Wikipedia, Internet, BRAVE, etc.), you must give as much information as possible on the title, description and links. The links are very important in the answer because it can be used later in the conversation, for follow-up interactions with the MCP Client or others MCP servers.

At the beginning of each answer but only if it's a complex question, make a bullet list to summarize what you are going to do between 5 and 10 points of what you will do next.

After your answer, if it's a complex question, always write a resume and a plan to follow at the end of the answer.

Use MCP server tools to go deeper when it's a structured work to do according the the complexity of the task.

For example, if the user asks something very simple like, "hello, how are you?" You don't have to do deep research and just answer normally, without task, without going deeper. Just answer directly.

如需查看此实现的完整示例，请参阅此 Github Gist。

---

安装流程

graph TD
    A[Parse User Input] --> B{URL Type?}
    B -->|GitHub shorthand| C[Construct full URL]
    B -->|Full URL| D[Clone Repository]
    C --> D
    D --> E[Install Dependencies]
    E --> F[Build Project]
    F --> G[Locate index.js]
    G --> H[Generate MCP Config]
    H --> I[Update Settings]

---

贡献

1. Fork 此仓库。
2. 创建一个新分支。
3. 进行修改。
4. 提交拉取请求。
5. 或者仅在 issues 部分提出建议并提供帮助。

---

许可证

MIT