Roo MCP Installer

Roo MCP 安装器

描述

这是一款命令行工具，旨在简化 Roo Model Context Protocol（MCP）服务的安装和管理。它会从 Git 仓库获取 MCP 服务代码，并在 Roo 环境中处理依赖项、配置和注册。

功能

• Git 仓库安装： 直接通过 GitHub 仓库 URL（例如，https://github.com/user/repo.git）或简写标识（user/repo）安装 MCP。
• 子目录支持： 使用冒号分隔符指定仓库中的某个子目录进行安装（例如，user/repo:subdir）。
• 安装范围： 支持 global（在项目之间共享，通常位于 ~/.roo/mcps）和 project（仅适用于当前目录，位于 ./.roo/mcps）两种安装范围。
• 自动检测项目类型： 根据标准配置文件识别项目类型：
  • Node.js（package.json）
  • Python（requirements.txt、pyproject.toml）
  • Go（go.mod、main.go）
  • Rust（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：go build -o <output_path> <target>
  • Node.js：如果存在构建脚本，且根据 main/bin 字段判断似乎有必要，则运行 npm run build（或 yarn/pnpm）。
• 环境变量配置：
  • 按优先级依次检查 mcp.json（最高优先级）、.env.example 或仓库 README.md 文件中的 JSON 代码块，以检测所需的环境变量。
  • 以交互方式提示用户输入检测到的变量值。
  • 对名称可能表示敏感信息的变量（例如，名称包含 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）。
• 丰富的 TUI： 使用 rich 库提供增强的终端用户界面，包括加载动画、进度条、样式化文本、表格和交互式提示。
• 调试模式： --debug 标志可将详细日志记录到控制台和日志文件，以便排查问题。
• 演示模式： --demo 标志（适用于 install 命令）可模拟安装过程，展示界面和计划执行的操作，但不会实际修改文件系统或运行命令。

用法

使用 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 许可证

Copyright (c) 2025 [Your Name or Organization]

特此免费授予任何获得本软件及相关文档文件（以下简称“软件”）副本的人不受限制地处理本软件的权利，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售本软件副本的权利，并允许获得本软件的人这样做，但须符合以下条件：

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

本软件按“原样”提供，不附带任何明示或默示的保证，包括但不限于适销性、特定用途适用性和非侵权的保证。在任何情况下，作者或版权持有人均不对因本软件或本软件的使用或其他处理而产生的任何索赔、损害或其他责任负责，无论该责任是基于合同、侵权还是其他原因。