🚀 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 许可。