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