Loading repository data…
Loading repository data…
robertheadley / repository
An MCP server installer for Roo Code. Handles the installation from Github, requirements, package management, update, installation and MCP Json configuration.
A transparent discovery signal based on current public GitHub metadata.
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
A command-line utility designed to streamline the installation and management of Roo Model Context Protocol (MCP) servers. It fetches MCP server code from Git repositories, handles dependencies, configuration, and registration within the Roo environment.
https://github.com/user/repo.git) or shorthand slugs (user/repo).user/repo:subdir).global (shared across projects, typically in ~/.roo/mcps) and project (specific to the current directory, in ./.roo/mcps) installation scopes.package.json)requirements.txt, pyproject.toml)go.mod, main.go)Cargo.toml) (Still in progress) (may not work)npm install (with fallback checks for yarn install or pnpm install)pip install -r requirements.txt (with fallback check for pip3)poetry install (with fallback check for pip install -e .)go mod downloadcargo build (also serves as dependency fetching)go build -o <output_path> <target>npm run build (or yarn/pnpm) if a build script exists and seems necessary based on main/bin fields.mcp.json (highest priority), , or JSON code blocks within the repository's file..env.exampleREADME.mdKEY, SECRET, TOKEN, PASSWORD).--skip-env flag.git, npm, node, python, go, cargo, bun, tsc, etc.).npm install -g bun).list command displays all MCPs installed in both global and project scopes, showing their names and installation paths.logs command allows viewing the application's log files.
--lines / -n: Show only the last N lines.--follow / -f: Continuously monitor the log file for new entries (similar to tail -f).rich library to provide an enhanced terminal user interface with spinners, progress bars, styled text, tables, and interactive prompts.--debug flag enables verbose logging to the console and log files for troubleshooting.--demo flag (for the install command) simulates the installation process, showing the UI and intended actions without actually modifying the file system or running commands.The script is run using python roo.py <command> [options].
Commands:
install <repo_input> [options]
<repo_input>: The repository URL, user/repo slug, or user/repo:subdir.--scope <global|project>: Set the installation scope (default: global).--skip-env: Skip interactive prompt for environment variables.--demo: Run installation in demo mode (no actual changes).--debug: Enable debug logging.list [options]
--debug: Enable debug logging.logs [options]
--lines N or -n N: Show the last N lines.--follow or -f: Follow log output in real-time.--debug: Enable debug logging.Install an MCP globally:
python roo.py install username/my-cool-mcp
Install an MCP into the current project:
python roo.py install https://github.com/username/project-specific-mcp.git --scope project
Install an MCP from a subdirectory, skipping environment variable setup:
python roo.py install username/mono-repo:tools/my-mcp --skip-env
Simulate an installation with debug output:
python roo.py install username/test-mcp --demo --debug
List all installed MCPs:
python roo.py list
View the latest log entries:
python roo.py logs
View the last 100 lines of the logs:
python roo.py logs --lines 100
Follow the logs in real-time:
python roo.py logs --follow
tomllib).requirements.txt below. Specific project types may require additional tools (like Node.js/npm, Go, Rust/Cargo) to be installed.requirements.txt)rich
MIT License
Copyright (c) 2025 [Your Name or Organization]
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.