Linode MCP Server

Сервер MCP (Model Context Protocol), который подключает ваш ИИ-ассистент или агент к облачной инфраструктуре Linode, позволяя управлять облачными ресурсами с помощью естественного общения. Построен на базе фреймворка FastMCP и поддерживает потоковые протоколы stdio, SSE и HTTP!

Что можно делать с помощью этого сервера?

Попросите Claude Desktop или VSCode Copilot Agent помочь вам с такими задачами, как:

• "Покажи мне все мои экземпляры в регионе Франкфурт"

• "Создай новый экземпляр в Осаке"

• "Создай балансировщик нагрузки для моих веб-серверов"

• "Настрой управляемую базу данных MySQL" и т.д.

Этот сервер предоставляет инструменты для следующих категорий сервисов Linode:

• 🖥️ instances — вычислительные экземпляры Linode

• 💾 volumes — тома блочного хранилища

• 🌐 networking — IP-адреса, брандмауэры, VLAN

• ⚖️ nodebalancers — балансировщики нагрузки для распределения трафика

• 🌎 regions — расположения дата-центров

• 📊 placement — политики размещения экземпляров

• 🔒 vpcs — сети Virtual Private Cloud

• 📦 objectStorage — S3-совместимое объектное хранилище

• 🔤 domains — управление DNS

• 🗄️ databases — управляемые базы данных MySQL/PostgreSQL

• ☸️ kubernetes — оркестрация контейнеров Kubernetes (LKE)

• 💿 images — пользовательские образы дисков для экземпляров

• 📜 stackScripts — скрипты автоматизации развертывания

• 🏷️ tags — метки для организации ресурсов

• 🎫 support — тикеты и запросы в службу поддержки

• 📊 longview — системные метрики и мониторинг

• 👤 profile — профиль пользователя и настройки безопасности

• 🏢 account — управление учетной записью, пользователями и биллингом

Начало работы

Быстрый старт с npx

Для использования этого сервера вам понадобится токен API Linode. Создайте его в настройках профиля Linode Cloud Manager.

# Start the server with your API token
npx @takashito/linode-mcp-server --token YOUR_LINODE_API_TOKEN

Установка вашего API-токена

Вы можете предоставить свой токен несколькими способами:

1. Опция командной строки:

   npx @takashito/linode-mcp-server --token YOUR_LINODE_API_TOKEN

2. Переменная окружения:

   export LINODE_API_TOKEN=your_token_here
   npx @takashito/linode-mcp-server

3. Файл окружения: Создайте файл .env в директории вашего проекта с содержимым:

   LINODE_API_TOKEN=your_token_here

   Затем запустите:

   npx @takashito/linode-mcp-server

Подключение к ИИ-клиентам

Claude Desktop

Откройте настройки Claude > Developer > Edit Config:

{
  "mcpServers": {
    "linode": {
      "command": "npx",
      "args": ["-y", "@takashito/linode-mcp-server", "--token", "YOUR_LINODE_API_TOKEN"]
    }
  }
}

VSCode/Cursor/Windsurf

Добавьте в ваш settings.json:

{
  "mcpServers": {
    "linode": {
      "command": "npx",
      "args": ["-y", "@takashito/linode-mcp-server", "--token", "YOUR_LINODE_API_TOKEN", "--categories", "instances,volumes,regions"]
    }
  }
}

⚠️ Примечание: Для клиентов на базе GPT-4o используйте --categories, чтобы ограничить количество инструментов и избежать ошибок контекстного окна.

Выбор категории инструментов

Вы можете выборочно включать инструменты с помощью параметра --categories:

# Enable only instances and volumes tools
npx @takashito/linode-mcp-server --token YOUR_TOKEN --categories instances,volumes

Или в конфигурации Claude Desktop:

{
  "mcpServers": {
    "linode": {
      "command": "npx",
      "args": [
        "-y",
        "@takashito/linode-mcp-server",
        "--token", 
        "YOUR_LINODE_API_TOKEN",
        "--categories",
        "instances,volumes,regions"
      ]
    }
  }
}

Доступные категории: instances, volumes, networking, nodebalancers, regions, placement, vpcs, objectStorage, domains, databases, kubernetes, images, stackScripts, tags, support, longview, profile, account

Чтобы увидеть все доступные категории:

npx @takashito/linode-mcp-server --list-categories

Варианты транспорта

1. Транспорт stdio — транспорт по умолчанию, совместимый с Claude Desktop

   # Default stdio transport
   npx @takashito/linode-mcp-server --token YOUR_TOKEN

2. Транспорт SSE — транспорт Server-Sent Events для веб-клиентов

   # Start with SSE transport on port 3000 /sse
   npx @takashito/linode-mcp-server --token YOUR_TOKEN --transport sse --port 3000 --endpoint /sse

3. Транспорт httpStream — транспорт HTTP-потоков для веб-клиентов

   # Start with HTTP streaming transport on port 8080 /mcp
   npx @takashito/linode-mcp-server --token YOUR_TOKEN --transport http --port 8080 --endpoint /mcp

Вы можете настроить порт и хост как для SSE, так и для HTTP-потокового транспорта:

• --port : Порт сервера (по умолчанию: http: 8080, sse: 3000)

• --endpoint : Путь сервера (по умолчанию: http: /mcp, sse: /sse)

• --host : Хост сервера (по умолчанию: 127.0.0.1)

Передача ключа API Linode через заголовок Authorization

Для транспорта http / sse вы можете запустить сервер mcp без параметра --token.

# Start with HTTP streaming transport on port 8080 /mcp at localhost
npx @takashito/linode-mcp-server --transport http

Настройте ваш mcp-клиент на добавление заголовка Authorization. linode-mcp-server пересылает этот API-токен для доступа к API Linode на бэкенде.

{
  "mcpServers": {
    "linode-remote-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8080/mcp",
        "--header",
        "Authorization: Bearer ${LINODE_API_TOKEN}"
      ],
      "env": {
        "LINODE_API_TOKEN": "..."
      }
    },
  }
}

Docker

Запустите MCP-сервер как контейнер с транспортом httpStream.

Сборка

docker build -t takashito/linode-mcp-server .

Запуск

# Basic usage (port 8080, all tool categories)
docker run -e LINODE_API_TOKEN=your_token -p 8080:8080 takashito/linode-mcp-server

# Custom port
docker run -e LINODE_API_TOKEN=your_token -e PORT=3000 -p 3000:3000 takashito/linode-mcp-server

# Limit tool categories
docker run -e LINODE_API_TOKEN=your_token -e CATEGORIES=instances,volumes,regions -p 8080:8080 takashito/linode-mcp-server

# Custom endpoint
docker run -e LINODE_API_TOKEN=your_token -e ENDPOINT=/api -p 8080:8080 takashito/linode-mcp-server

Переменные окружения

Подключение с помощью MCP-клиента

{
  "mcpServers": {
    "linode": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8080/mcp",
        "--header",
        "Authorization: Bearer ${LINODE_API_TOKEN}"
      ],
      "env": {
        "LINODE_API_TOKEN": "your_token"
      }
    }
  }
}

Доступные инструменты

Этот MCP-сервер предоставляет следующие инструменты для взаимодействия с сервисами API Linode:

🖥️ Экземпляры (Instances)

Управление вычислительными экземплярами Linode, включая создание, удаление и операции питания.

Операции с экземплярами

• list_instances - Получить список всех экземпляров Linode

• get_instance - Получить детали конкретного экземпляра Linode

• create_instance - Создать новый экземпляр Linode

• update_instance - Обновить экземпляр Linode

• delete_instance - Удалить экземпляр Linode

• reboot_instance - Перезагрузить экземпляр Linode

• boot_instance - Включить экземпляр Linode

• shutdown_instance - Выключить экземпляр Linode

• resize_instance - Изменить размер экземпляра Linode

• clone_instance - Клонировать экземпляр Linode в новый экземпляр

• rebuild_instance - Пересобрать экземпляр Linode с новым образом

• rescue_instance - Загрузить экземпляр Linode в режиме восстановления

• reset_root_password - Сбросить пароль root для экземпляра Linode

• initiate_migration - Инициировать миграцию дата-центра для экземпляра Linode

• upgrade_linode - Обновить экземпляр Linode

Конфигурация экземпляра

• list_instance_configs - Получить все профили конфигурации для экземпляра Linode

• get_instance_config - Получить конкретный профиль конфигурации для экземпляра Linode

• create_instance_config - Создать новый профиль конфигурации для экземпляра Linode

• update_instance_config - Обновить профиль конфигурации для экземпляра Linode

• delete_instance_config - Удалить профиль конфигурации для экземпляра Linode

Интерфейсы профиля конфигурации

• list_config_interfaces - Список всех интерфейсов для профиля конфигурации

• get_config_interface - Получить детали конкретного интерфейса профиля конфигурации

• create_config_interface - Создать новый интерфейс для профиля конфигурации

• update_config_interface - Обновить интерфейс для профиля конфигурации

• delete_config_interface - Удалить интерфейс из профиля конфигурации

• reorder_config_interfaces - Изменить порядок интерфейсов для профиля конфигурации

Диски экземпляра

• list_instance_disks - Получить все диски для экземпляра Linode

• get_instance_disk - Получить конкретный диск для экземпляра Linode

• create_instance_disk - Создать новый диск для экземпляра Linode

• update_instance_disk - Обновить диск для экземпляра Linode

• delete_instance_disk - Удалить диск для экземпляра Linode

• resize_instance_disk - Изменить размер диска экземпляра Linode

• clone_disk - Клонировать диск в новый диск

• reset_disk_root_password - Сбросить пароль root диска

Резервные копии экземпляра

• list_backups - Получить список всех резервных копий для экземпляра Linode

• get_backup - Получить детали конкретной резервной копии

• create_snapshot - Создать снимок для экземпляра Linode

• cancel_backups - Отменить резервное копирование для экземпляра Linode

• enable_backups - Включить резервное копирование для экземпляра Linode

• restore_backup - Восстановить резервную копию для экземпляра Linode

Управление IP

• get_networking_information - Получить сетевую информацию для экземпляра Linode

• allocate_ipv4_address - Выделить IPv4-адрес для экземпляра Linode

• get_ip_address - Получить детали конкретного IP-адреса

• update_ip_address_rdns - Обновить обратный DNS для IP-адреса

• delete_ipv4_address - Удалить IPv4-адрес

Управление брандмауэром

• list_linode_firewalls - Список брандмауэров для экземпляра Linode

• apply_linode_firewalls - Применить брандмауэры к экземпляру Linode

Статистика и передача данных экземпляра

• get_instance_stats - Получить текущую статистику для экземпляра Linode

• get_instance_stats_by_date - Получить статистику для экземпляра Linode за конкретный месяц

• get_network_transfer - Получить информацию о передаче данных по сети для экземпляра Linode

• get_monthly_network_transfer - Получить ежемесячную статистику передачи данных по сети для экземпляра Linode

Связанные ресурсы

• list_instance_nodebalancers - Список NodeBalancer'ов, привязанных к экземпляру Linode

• list_instance_volumes - Список томов, привязанных к экземпляру Linode

Ядра и типы экземпляров

• list_kernels - Получить список всех доступных ядер

• get_kernel - Получить детали конкретного ядра

• list_instance_types - Получить список всех доступных типов Linode

• get_instance_type - Получить детали конкретного типа Linode

💾 Тома (Volumes)

Управление томами блочного хранилища, которые могут быть присоединены к экземплярам Linode.

• list_volumes - Получить список всех томов

• get_volume - Получить детали конкретного тома

• create_volume - Создать новый том

• delete_volume - Удалить том

• attach_volume - Присоединить том к экземпляру Linode

• detach_volume - Отсоединить том от экземпляра Linode

• resize_volume - Изменить размер тома

🌐 Сеть (Networking)

Управление IP-адресами, брандмауэрами и сетевой инфраструктурой.

Управление IP-адресами

• get_ip_addresses - Получить все IP-адреса

• get_ip_address - Получить детали конкретного IP-адреса

• update_ip_address - Обновить обратный DNS для IP-адреса

• allocate_ip - Выделить новый IP-адрес

• share_ips - Совместное использование IP-адресов между Linode

Управление IPv6

• get_ipv6_ranges - Получить все диапазоны IPv6

• get_ipv6_range - Получить конкретный диапазон IPv6

• get_ipv6_pools - Получить все пулы IPv6

Управление брандмауэром

• get_firewalls - Получить все брандмауэры

• get_firewall - Получить детали конкретного брандмауэра

• create_firewall - Создать новый брандмауэр

• update_firewall - Обновить брандмауэр

• delete_firewall - Удалить брандмауэр

Правила брандмауэра

• get_firewall_rules - Получить все правила для конкретного брандмауэра

• update_firewall_rules - Обновить правила для конкретного брандмауэра

Устройства брандмауэра

• get_firewall_devices - Получить все устройства для конкретного брандмауэра

• create_firewall_device - Создать новое устройство для конкретного брандмауэра

• delete_firewall_device - Удалить устройство из конкретного брандмауэра

Управление VLAN

• get_vlans - Получить все VLAN

• get_vlan - Получить конкретный VLAN

🔤 Домены (Domains)

Управление DNS-доменами и записями, размещенными в DNS-сервисах Linode.

• list_domains - Получить список всех доменов

• get_domain - Получить детали конкретного домена

• create_domain - Создать новый домен

• update_domain - Обновить существующий домен

• delete_domain - Удалить домен

• list_domain_records - Получить список всех записей домена

• get_domain_record - Получить детали конкретной записи домена

• create_domain_record - Создать новую запись домена

• update_domain_record - Обновить запись домена

• delete_domain_record - Удалить запись домена

• `import_domain_