README - mcp-server by nebius

[Beta] Nebius MCP Server

This service allows AI agents and assistants to fetch documentation for the Nebius services and execute Nebius CLI commands through the Model Context Protocol.

Disclaimer

Important: This is a beta version. Use it carefully and at your own risk. There are no guarantees provided regarding stability, safety, or correctness.

In the current implementation, the MCP server allows execution of any Nebius CLI commands, which may lead to destructive and insecure consequences. Always double-check the command suggested by the assistant before executing it. Never use the Allow always option for the nebius_cli_execute tool.

Scenarios

There are 2 main scenarios for this MCP server:

Get and analyze the documentation for every service

Examples (queries to the AI agent):
- How to create a compute instance at Nebius?
- How to create a storage bucket at Nebius?
Execute commands and get results

Examples:
- Provide me a list of all storage buckets within the project: project-e00some-cool-project
- Get me a list of the available compute platforms
- Show the details about the compute instance by name: some-cool-instance

Requirements

Python (version >=3.13) with uv package manager installed
Nebius CLI (version >=0.12.65) installed locally with at least one profile configured

On macOS, it’s recommended to install uv via Homebrew: brew install uv.

Installation

// update to the latest version of Nebius CLI
nebius update

// clone mcp server repository
cd ~/.nebius
git clone git@github.com:nebius/mcp-server.git

Use the next command to configure your MCP-compatible client (see examples below):

uv run --with fastmcp fastmcp run ~/.nebius/mcp-server/server.py

Using Claude Desktop

Install Claude Desktop: https://claude.ai/download
Open the Claude Desktop configuration file: Claude -> Settings -> Developer -> Edit Config

Edit the configuration file to include the Nebius MCP Server:

{
     "mcpServers": {
         "Nebius MCP Server": {
             "command": "uv",
             "args": [
                 "run",
                 "--with",
                 "fastmcp",
                 "fastmcp",
                 "run",
                 "~/.nebius/mcp-server/server.py"
             ]
         }
     }
 }

Restart Claude Desktop:
- After restarting, click "Search and tools" icon in the bottom left corner of the input box
- You should see Nebius MCP Server is available for use

Using VSCode Copilot

Ensure you have the Copilot extension installed and are logged in
Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run mcp: Add Server
Choose Command (stdio) and enter the following command: uv run --with fastmcp fastmcp run ~/.nebius/mcp-server/server.py
Open the Chat panel and select Agent mode
- You will now see the new MCP and its available tools by clicking the :hammer_and_wrench: button

Tools

nebius_profiles - Information about configured Nebius CLI profiles
nebius_available_services - List of the available Nebius services
nebius_cli_help - Detailed help documentation for the Nebius CLI commands for the specified service
nebius_cli_execute - Generate and execute Nebius CLI command and return the result

License

This project is licensed under the MIT License. See the file for details.