AI导哈

MCP服务器安装工具

一个命令行工具，用于简化Roo Model Context Protocol (MCP)服务器的安装和管理，支持从Git仓库获取代码、处理依赖、配置和环境变量设置。

  • by robertheadley
  • Python
  • 本地部署
  • 10 星标
  • 更新于
在 GitHub 查看 robertheadley/Roo-Code-MCP-installer

使用说明

Roo MCP安装程序

描述

一个命令行实用程序，旨在简化Roo模型上下文协议（MCP）服务器的安装和管理。它从Git存储库中获取MCP服务器代码，处理Roo环境中的依赖关系、配置和注册。

特性

  • Git存储库安装： 直接从GitHub存储库URL安装MCP（例如。， https://github.com/user/repo.git)或简写蛞蝓(user/repo).
  • 子目录支持： 允许使用冒号分隔符从存储库内的特定子目录进行安装（例如。， user/repo:subdir).
  • 安装范围： 支持两者 global （跨项目共享，通常在 ~/.roo/mcps)以及 project （特定于当前目录，在 ./.roo/mcps)安装范围。
  • 自动项目类型检测： 根据标准配置文件标识项目类型：
    • Node.js(package.json)
    • pythonrequirements.txt, pyproject.toml)
    • 去吧(go.mod, main.go)
    • 生锈(Cargo.toml)（仍在进行中）（可能不起作用）
  • 依赖关系管理： 使用检测到的包管理器自动安装项目依赖关系：
    • npm install （带有回退检查 yarn install 或 pnpm install)
    • pip install -r requirements.txt （带回退检查 pip3)
    • poetry install （带回退检查 pip install -e .)
    • go mod download
    • cargo build （也用作获取依赖项）
  • 构建步骤执行： 必要时自动运行构建命令：
    • 去： go build -o <output_path> <target>
    • Node.js： npm run build （或 yarn/pnpm)如果构建脚本存在，并且似乎有必要基于 main/bin 领域。
  • 环境变量配置：
    • 通过检查来检测所需的环境变量 mcp.json （最高优先级）， .env.example，或存储库中的JSON代码块 README.md 文件。
    • 交互式提示用户输入检测到的变量的值。
    • 屏蔽名称暗示敏感度的变量输入（例如，包含 KEY, SECRET, TOKEN, PASSWORD).
    • 允许使用跳过交互式配置 --skip-env 旗帜。
  • 自动工具检查和安装：
    • 检查是否存在必要的命令行工具(git, npm, node, python, go, cargo, bun, tsc等等）。
    • 如果存在已知的安装命令（例如。， npm install -g bun).
  • 列出已安装的MCP： 这 list 命令显示全局和项目范围内安装的所有MCP，显示其名称和安装路径。
  • 日志查看： 这 logs 命令允许查看应用程序的日志文件。
    • --lines / -n：仅显示最后N行。
    • --follow / -f：持续监控日志文件中的新条目（类似于 tail -f).
  • 富途： 利用 rich 库，提供具有微调器、进度条、样式化文本、表格和交互式提示的增强型终端用户界面。
  • 调试模式： 这 --debug 标志允许将详细日志记录到控制台和日志文件中，以便进行故障排除。
  • 演示模式： 这 --demo 旗帜（为 install 命令）模拟安装过程，显示UI和预期操作，而无需实际修改文件系统或运行命令。

用法

该脚本使用以下命令运行 python roo.py <command> [options].

命令：

  • install <repo_input> [options]
    • 安装或更新MCP服务器。
    • <repo_input>：存储库URL， user/repo 蛞蝓，或 user/repo:subdir.
    • --scope <global|project>：设置安装范围（默认值： global).
    • --skip-env：跳过环境变量的交互式提示。
    • --demo：在演示模式下运行安装（没有实际更改）。
    • --debug：启用调试日志记录。
  • list [options]
    • 列出已安装的MCP服务器。
    • --debug：启用调试日志记录。
  • logs [options]
    • 显示日志文件。
    • --lines N 或 -n N：显示最后N行。
    • --follow 或 -f：实时跟踪日志输出。
    • --debug：启用调试日志记录。

例子

全局安装MCP：

python roo.py install username/my-cool-mcp

在当前项目中安装MCP：

python roo.py install https://github.com/username/project-specific-mcp.git --scope project

从子目录安装MCP，跳过环境变量设置：

python roo.py install username/mono-repo:tools/my-mcp --skip-env

使用调试输出模拟安装：

python roo.py install username/test-mcp --demo --debug

列出所有已安装的MCP：

python roo.py list

查看最新日志条目：

python roo.py logs

查看日志的最后100行：

python roo.py logs --lines 100

实时跟踪日志：

python roo.py logs --follow

依赖项

  • python 需要3.11或更高版本（由于使用 tomllib).
  • Git： 必须在系统的PATH中安装并可访问。
  • 第三方Python包： 看 requirements.txt 在......下面特定的项目类型可能需要安装额外的工具（如Node.js/npm、Go、Rust/Cargo）。

需求文件(requirements.txt)

rich

许可证

MIT许可证

版权所有（c）2025[您的姓名或组织]

特此免费向任何获得副本的人授予许可 本软件和相关文档文件（“软件”），以处理 在软件中不受限制，包括但不限于权利 使用、复制、修改、合并、发布、分发、再许可和/或销售 软件的副本，并允许软件的接收者 根据以下条件提供：

上述版权声明和本许可声明应包含在所有 软件的副本或实质性部分。

软件按“原样”提供，不提供任何形式的明示或明示担保 隐含的，包括但不限于适销性保证， 适用于特定目的且不造成伤害。在任何情况下 作者或版权持有人对任何索赔、损害赔偿或其他 因以下原因产生的责任，无论是在合同、侵权或其他诉讼中， 出于或与软件、使用或其他交易有关 软件。

相关 MCP