Skip to main content
Glama

Linode MCP 서버

main version npm version npm downloads

AI 어시스턴트나 에이전트를 Linode 클라우드 인프라에 연결하여 자연스러운 대화를 통해 클라우드 리소스를 관리할 수 있게 해주는 MCP(Model Context Protocol) 서버입니다. FastMCP 프레임워크로 구축되었으며 stdio, SSE 및 HTTP 스트리밍 전송을 지원합니다!

무엇을 할 수 있나요?

Claude Desktop이나 VSCode Copilot 에이전트에게 다음과 같은 작업을 요청할 수 있습니다:

  • "프랑크푸르트 리전에 있는 내 모든 인스턴스 보여줘"

  • "오사카에 새 인스턴스 생성해줘"

  • "웹 서버를 위한 로드 밸런서 생성해줘"

  • "관리형 MySQL 데이터베이스 설정해줘" 등

이 서버는 다음 Linode 서비스 카테고리에 대한 도구를 제공합니다:

  • 🖥️ instances - Linode 컴퓨팅 인스턴스

  • 💾 volumes - 블록 스토리지 볼륨

  • 🌐 networking - IP 주소, 방화벽, VLAN

  • ⚖️ nodebalancers - 트래픽 분산을 위한 로드 밸런서

  • 🌎 regions - 데이터 센터 위치

  • 📊 placement - 인스턴스 배치 정책

  • 🔒 vpcs - 가상 프라이빗 클라우드 네트워크

  • 📦 objectStorage - S3 호환 객체 스토리지

  • 🔤 domains - DNS 관리

  • 🗄️ databases - 관리형 MySQL/PostgreSQL 데이터베이스

  • ☸️ kubernetes - Kubernetes 컨테이너 오케스트레이션 (LKE)

  • 💿 images - 인스턴스용 커스텀 디스크 이미지

  • 📜 stackScripts - 배포 자동화 스크립트

  • 🏷️ tags - 리소스 구성 레이블

  • 🎫 support - 지원 티켓 및 요청

  • 📊 longview - 시스템 메트릭 및 모니터링

  • 👤 profile - 사용자 프로필 및 보안 설정

  • 🏢 account - 계정 관리, 사용자 및 결제

시작하기

npx를 이용한 빠른 시작

이 서버를 사용하려면 Linode API 토큰이 필요합니다. 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

AI 클라이언트에 연결

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)

Authorization 헤더를 통한 Linode API 키 전달

http / sse 전송의 경우, --token 매개변수 없이 mcp 서버를 실행할 수 있습니다.

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

Authorization 헤더를 추가하도록 mcp 클라이언트를 구성하세요. linode-mcp-server는 이 API 토큰을 전달하여 백엔드에서 Linode API에 액세스합니다.

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

Docker

httpStream 전송을 사용하여 MCP 서버를 컨테이너로 실행하세요.

빌드

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

환경 변수

변수

기본값

설명

LINODE_API_TOKEN

(필수)

Linode API 토큰. Authorization 헤더를 통해서도 전달 가능합니다.

PORT

8080

서버 포트

ENDPOINT

/mcp

서버 엔드포인트 경로

CATEGORIES

(전체)

활성화할 도구 카테고리의 쉼표로 구분된 목록

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 서버는 Linode API 서비스와 상호 작용하기 위한 다음 도구를 제공합니다:

🖥️ 인스턴스

생성, 삭제 및 전원 작업을 포함하여 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 인스턴스를 새 Linode로 복제

  • rebuild_instance - 새 이미지로 Linode 인스턴스 재구축

  • rescue_instance - Linode 인스턴스를 복구 모드로 부팅

  • reset_root_password - Linode 인스턴스의 루트 비밀번호 재설정

  • initiate_migration - Linode 인스턴스에 대한 DC 마이그레이션 시작

  • 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 - 디스크 업데이트

  • delete_instance_disk - 디스크 삭제

  • resize_instance_disk - 디스크 크기 조정

  • clone_disk - 디스크를 새 디스크로 복제

  • reset_disk_root_password - 디스크 루트 비밀번호 재설정

인스턴스 백업

  • list_backups - Linode 인스턴스에 대한 모든 백업 목록 가져오기

  • get_backup - 특정 백업에 대한 세부 정보 가져오기

  • create_snapshot - Linode 인스턴스에 대한 스냅샷 생성

  • cancel_backups - Linode 인스턴스에 대한 백업 취소

  • enable_backups - 백업 활성화

  • restore_backup - Linode 인스턴스로 백업 복원

IP 관리

  • get_networking_information - Linode 인스턴스에 대한 네트워킹 정보 가져오기

  • allocate_ipv4_address - Linode 인스턴스에 IPv4 주소 할당

  • get_ip_address - 특정 IP 주소에 대한 세부 정보 가져오기

  • update_ip_address_rdns - IP 주소에 대한 역방향 DNS 업데이트

  • 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 - Linode 인스턴스에 연결된 NodeBalancer 나열

  • list_instance_volumes - Linode 인스턴스에 연결된 볼륨 나열

커널 및 인스턴스 유형

  • list_kernels - 사용 가능한 모든 커널 목록 가져오기

  • get_kernel - 특정 커널에 대한 세부 정보 가져오기

  • list_instance_types - 사용 가능한 모든 Linode 유형 목록 가져오기

  • get_instance_type - 특정 Linode 유형에 대한 세부 정보 가져오기

💾 볼륨

Linode 인스턴스에 연결할 수 있는 블록 스토리지 볼륨을 관리합니다.

  • list_volumes - 모든 볼륨 목록 가져오기

  • get_volume - 특정 볼륨에 대한 세부 정보 가져오기

  • create_volume - 새 볼륨 생성

  • delete_volume - 볼륨 삭제

  • attach_volume - Linode 인스턴스에 볼륨 연결

  • detach_volume - Linode 인스턴스에서 볼륨 분리

  • resize_volume - 볼륨 크기 조정

🌐 네트워킹

IP 주소, 방화벽 및 네트워크 인프라를 관리합니다.

IP 주소 관리

  • get_ip_addresses - 모든 IP 주소 가져오기

  • get_ip_address - 특정 IP 주소에 대한 세부 정보 가져오기

  • update_ip_address - IP 주소에 대한 역방향 DNS 업데이트

  • allocate_ip - 새 IP 주소 할당

  • share_ips - Linode 간 IP 주소 공유

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 가져오기

🔤 도메인

Linode의 DNS 서비스에서 호스팅되는 DNS 도메인 및 레코드를 관리합니다.

  • list_domains - 모든 도메인 목록 가져오기

  • get_domain - 특정 도메인에 대한 세부 정보 가져오기

  • create_domain - 새 도메인 생성

  • update_domain - 기존 도메인 업데이트

  • delete_domain - 도메인 삭제

  • list_domain_records - 도메인에 대한 모든 도메인 레코드 목록 가져오기

  • get_domain_record - 특정 도메인 레코드에 대한 세부 정보 가져오기

  • create_domain_record - 새 도메인 레코드 생성

  • update_domain_record - 도메인 레코드 업데이트

  • `delete_domain

-
security - not tested
A
license - permissive license
-
quality - not tested

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/takashito/linode-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server