setup-tooluniverse

What problem does it solve?

The Setup ToolUniverse skill guides users through environment detection, installation, MCP configuration, and validation testing to ensure ToolUniverse runs smoothly in Cursor or Claude Desktop. It addresses challenges of compatibility, proper configuration, and troubleshooting common issues, saving time and reducing setup friction.

Core Features & Use Cases

• Automated discovery of OS, Python version, package managers (pip/uv) and suitable installation method (pip/uv/dev).
• Step-by-step MCP integration setup with compact mode to avoid context overflow, including creating or validating mcp.json configurations for Cursor and Claude Desktop.
• Validation workflow with scripts to check prerequisites, installation integrity, MCP connection, and diagnostics, plus quick verification of ToolUniverse availability.
• Real-world use: a data scientist or developer sets up ToolUniverse for the first time, then tests MCP connection and runs initial queries like list_tools or grep_tools.
• Troubleshooting guidance for common issues (Python version, command not found, path issues) with actionable solutions.

Quick Start

1. Run prerequisites: python scripts/check_prerequisites.py
2. Install ToolUniverse: pip install tooluniverse
3. Verify installation: python scripts/verify_installation.py
4. Configure MCP in Cursor/Claude Desktop, enabling compact mode
5. Test MCP connection: python scripts/test_mcp_connection.py
6. If issues arise, run diagnostic: python scripts/diagnose_setup.py