金大哥 - Linode MCP 详情

article

README

🚀 Linode MCP 服务器

一个用于通过 Linode 的 API 管理云资源的模型上下文协议 (MCP) 服务器。此包使大型语言模型 (LLMs) 如 Claude 能够通过标准接口管理 Linode 实例，为云资源管理提供了便捷途径。

🚀 快速开始

Linode MCP 服务器可助力大型语言模型管理 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

与 Claude for Desktop 结合使用

安装包：

pip install linode-mcp

手动编辑您的 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"]
    }
  }
}

重启 Claude for Desktop
在与 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。

叉克隆仓库
创建功能分支 (git checkout -b feature/amazing-feature)
提交更改 (git commit -m '添加一些神奇的功能')
推送到分支 (git push origin feature/amazing-feature)
提交拉取请求

📄 许可证

本项目受 MIT License 许可。

Linode