Linode

🚀 Linode MCP サーバー

このサーバーは、Linode の API を通じてクラウドリソースを管理するためのモデルコンテキストプロトコル (MCP) サーバーです。このパッケージにより、Claude などの大規模言語モデル (LLMs) が標準インターフェースを通じて Linode インスタンスを管理できるようになります。

✨ 主な機能

• Linode のリージョン、インスタンスタイプ、インスタンスを一覧表示
• Linode インスタンスの作成、詳細表示、削除、再起動
• LLMs が Linode リソースを管理するための安全で使いやすいインターフェース
• Claude などの MCP 対応 AI アシスタントと完全互換

📦 インストール

インストール前の準備

Linode API キーを環境変数に設定する必要があります。以下の 2 つの方法があります。

環境変数として設定

export LINODE_API_KEY=your_api_key_here

.env ファイルを使用

プロジェクトディレクトリ内に .env ファイルを作成し、以下のように記述します。

LINODE_API_KEY=your_api_key_here

API キーは Linode クラウドコンソール で生成できます。

インストール方法

PyPI からインストール（推奨）

pip install linode-mcp

uv を使用してインストール

uvx pip install linode-mcp
uvx linode-mcp --api-key $LINODE_API_KEY

ソースコードからインストール

# リポジトリをクローン
git clone https://github.com/yourusername/linode-mcp.git
cd linode-mcp

# 開発モードでパッケージをインストール
./scripts/install.sh

💻 使用例

コマンドラインツールとして使用

# デフォルト設定で実行
linode-mcp

# デバッグログを有効にする
linode-mcp --debug

# コマンドラインで API キーを指定する
linode-mcp --api-key your_api_key_here

Claude for Desktop と組み合わせて使用

1. パッケージをインストールする

pip install linode-mcp

2. Claude Desktop の設定ファイルを手動で編集する

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "linode": {
      "command": "linode-mcp",
      "args": ["--api-key", "your_api_key_here"]
    }
  }
}

3. Claude for Desktop を再起動する

4. Claude との会話で以下のことを要求できる

• すべての Linode インスタンスを一覧表示
• 新しい Linode インスタンスを作成
• 特定のインスタンスの詳細を取得
• インスタンスを再起動または削除

例:

• "すべての Linode インスタンスを表示"
• "フランクフルトリージョンに 2GB の Linode を作成し、Debian 11 をインストール"
• "ID が 12345 のインスタンスを再起動"

📚 ドキュメント

利用可能なツール

このパッケージは以下の MCP ツールを提供します。

• list_regions - すべての利用可能な Linode リージョンを一覧表示

以下のツールは今後追加予定です。

• list_instance_types - すべての利用可能な Linode インスタンスタイプとその価格を一覧表示
• list_instances - すべての既存の Linode インスタンスを一覧表示
• create_instance - 新しい Linode インスタンスを作成
• get_instance - 特定の Linode インスタンスの詳細を取得
• delete_instance - Linode インスタンスを削除
• reboot_instance - Linode インスタンスを再起動

開発

プロジェクト構造

linode-mcp/
├── bin/                  # コマンドラインスクリプト
├── src/                  # ソースコード
│   └── linode_mcp/       # メインパッケージ
│       ├── tools/        # MCP ツールの実装
│       └── server.py     # MCP サーバーの実装
├── setup.py              # パッケージインストールファイル
└── README.md             # このファイル

貢献方法

貢献を歓迎します！自由に Pull Request を送信してください。

1. リポジトリをフォークしてクローンする
2. 機能ブランチを作成する (git checkout -b feature/amazing-feature)
3. 変更をコミットする (git commit -m 'いくつかの素敵な機能を追加')
4. ブランチにプッシュする (git push origin feature/amazing-feature)
5. プルリクエストを送信する

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。