Linode

🚀 Linode MCP 服務器

一個用於通過 Linode 的 API 管理雲資源的模型上下文協議 (MCP) 服務器。此包能讓大型語言模型 (LLMs) 如 Claude 藉助標準接口管理 Linode 實例，為雲資源管理帶來便利。

✨ 主要特性

• 可列出 Linode 區域、實例類型和實例。
• 支持創建、查看詳細信息、刪除和重啟 Linode 實例。
• 為 LLMs 提供安全且易於使用的界面來管理 Linode 資源。
• 與支持 MCP 的 AI 助手（如 Claude）完全兼容。

📦 安裝指南

環境變量與 API 密鑰設置

您可以將 Linode API 密鑰設置為環境變量：

export LINODE_API_KEY=your_api_key_here

或者使用項目目錄中的 .env 文件：

LINODE_API_KEY=your_api_key_here

您可在 Linode 雲控制檯 中生成 API 密鑰。

安裝方式

從 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

高級用法

# 結合不同參數實現更靈活的操作，例如同時啟用調試日誌並指定 API 密鑰
linode-mcp --debug --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 許可。