mcp

This MCP server enables AI agents and assistants to interact with Nebius services by providing documentation access and the ability to execute Nebius CLI commands. It exposes tools to fetch profile information, list available Nebius services, display detailed Nebius CLI help for specific commands, and generate/execute Nebius CLI commands. Use it when you want to quickly explore Nebius capabilities, understand CLI options for a service, or run Nebius commands directly from your agent workflow. Remember that command execution is restricted by safety measures by default to prevent dangerous or token-leaking operations; always review generated commands before running them.

Available tools:

• nebius_profiles: Retrieve information about configured Nebius CLI profiles.
• nebius_available_services: List the Nebius services that are available in your environment.
• nebius_cli_help: Show detailed help documentation for Nebius CLI commands for a specified service.
• nebius_cli_execute: Generate a Nebius CLI command for a given action and execute it, returning the results.

Prerequisites:

• Python 3.13 or newer
• uv package manager installed (via pip install uv or your preferred method) as described in Nebius/MCP docs
• Nebius CLI installed locally (version >= 0.12.65) and configured with at least one profile

Installation steps:

1. Ensure your environment has Python and uv installed

   python3 --version
   # should show Python 3.13 or newer
   uv --version
   

2. Install Nebius CLI and configure a profile (if not already done) following Nebius docs

   # Example: install Nebius CLI and ensure a profile exists
   nebius update
   nebius login --profile default
   

3. Install or refresh the MCP server package using uvx (as described in the README)

   uvx --refresh-package nebius-mcp-server "nebius-mcp-server@git+https://github.com/nebius/mcp-server@main"
   

4. Run or test the MCP server via uvx (if you want to start it locally for testing, use the same refresh/exec flow as used for installation). Ensure SAFE_MODE and any required environment variables are set as needed.

Tips and considerations:

• The MCP server may execute Nebius CLI commands directly; always verify the suggested command before execution to avoid destructive actions.
• The default SAFE_MODE prevents potentially dangerous commands (e.g., those that perform updates or deletions). You can control safety via the SAFE_MODE environment variable (true by default).
• Tokens and access keys should never be exposed or passed as command arguments. The server forbids such actions in dedicated checks.
• If you encounter issues with package refresh, ensure network access to GitHub and that your environment allows uvx to install the package from the specified repository.
• If you customize Claude Desktop or VSCode Copilot integration, follow the integration examples provided in the README to connect to the Nebius MCP Server reliably.