MCP 服务器

Linode MCP Server

一个模型上下文协议（Model Context Protocol）服务器，它使像 Claude 这样的大型语言模型能够管理 Linode 云资源，包括列出区域、创建、查看、删除和重启 Linode 实例。

README

Linode MCP 服务器

一个模型上下文协议 (MCP) 服务器，用于与 Linode 的 API 交互以管理云资源。此软件包使像 Claude 这样的大型语言模型 (LLM) 能够通过标准化接口管理 Linode 实例。

特性

列出 Linode 区域、实例类型和实例
创建、查看详细信息、删除和重启 Linode 实例
安全且易于使用的界面，供 LLM 管理 Linode 资源
完全兼容支持 MCP 的 AI 助手，如 Claude

安装和配置

将您的 Linode API 密钥设置为环境变量：

export LINODE_API_KEY=your_api_key_here

或者在项目目录中使用 .env 文件：

LINODE_API_KEY=your_api_key_here

您可以从 Linode Cloud Manager 生成 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 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 Desktop
在与 Claude 的对话中，您现在可以要求它：
- 列出您的 Linode 实例
- 创建一个新的 Linode 实例
- 获取有关特定实例的详细信息
- 重启或删除实例

示例提示：

"Show me all my Linode instances" (显示我所有的 Linode 实例)
"Create a new 2GB Linode in the Frankfurt region with Debian 11" (在法兰克福区域使用 Debian 11 创建一个新的 2GB Linode)
"Reboot my instance with ID 12345" (重启 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             # 此文件