MCP 服务器

Nebius MCP Server

Enables AI agents to fetch Nebius cloud service documentation and execute Nebius CLI commands for managing cloud resources like compute instances and storage buckets through natural language interactions.

README

[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

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

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

Restricted actions and safe mode

For safety reasons Nebius MCP server always forbids execution of any commands that either accept tokens or access keys as an argument or return them as a result.

Safe mode: by default MCP server also does not allow to execute commands that can make "update", "delete" and other commands that can make potentially dangerous changes. We don't recommend changing the default behavior. However it can be controlled using the SAFE_MODE=true|false environment variable for the MCP server.

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": "uvx",
             "args": [
                 "--refresh-package",
                 "nebius-mcp-server",
                 "nebius-mcp-server@git+https://github.com/nebius/mcp-server@main"
             ],
             "env": {}
         }
     }
 }

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: uvx --refresh-package nebius-mcp-server "nebius-mcp-server@git+https://github.com/nebius/mcp-server@main"
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