项目简介
'mcp_doctl' 是一个 MCP 服务器,它允许用户通过 'doctl' 命令行工具管理 DigitalOcean 资源。它提供了一系列工具,用于创建、列出、删除和管理 DigitalOcean Droplet,以及执行其他 DigitalOcean 相关操作。
主要功能点
- Droplet 管理: 创建、列出、删除 DigitalOcean Droplet (云服务器实例)。
- Droplet 操作: 在 Droplet 上执行命令、重启、关机、调整大小、重建镜像。
- 资源信息查询: 列出可用的 Droplet 镜像、区域、尺寸和 1-Click 应用镜像。
- 账户信息: 获取 DigitalOcean 账户的 Droplet 数量限制。
- Droplet 状态检查: 检查 Droplet 是否响应 SSH 连接。
安装步骤
- 环境准备: 确保您的系统已安装 Python 和 uv 包管理器。
- 仓库克隆: 将 'goose_mcp' 仓库克隆到本地:
git clone https://github.com/Jay4242/goose_mcp.git cd goose_mcp - 进入目录: 进入 'mcp_doctl' 目录:
cd mcp_doctl - 创建虚拟环境: 运行 'uv sync' 命令创建 Python 虚拟环境并安装依赖:
uv sync - 配置环境变量: 设置 DigitalOcean API 密钥环境变量 'DIGITALOCEAN_SSH_KEY_ID'。您需要在 DigitalOcean 控制面板获取 API 密钥,并将其设置为环境变量。例如,在 Linux/macOS 中,您可以添加到 '~/.bashrc' 或 '~/.zshrc' 文件中:
然后执行 'source ~/.bashrc' 或 'source ~/.zshrc' 使环境变量生效。export DIGITALOCEAN_SSH_KEY_ID="your_digitalocean_api_key"
服务器配置
为了让 MCP 客户端(如 Goose)连接到 'mcp_doctl' 服务器,您需要配置服务器的启动命令。以下是一个 JSON 格式的配置示例,您需要将其添加到 MCP 客户端的服务器配置中。
{ "server_name": "doctl", "command": "/path/to/goose_mcp/mcp_doctl/.venv/bin/mcp_doctl", "args": [] }
参数说明:
- '"server_name"': 服务器名称,设置为 '"doctl"' 以便在客户端中引用。
- '"command"': 重要: MCP 服务器的启动命令。请将 '"/path/to/goose_mcp/mcp_doctl/.venv/bin/mcp_doctl"' 替换为 'mcp_doctl' 启动脚本在您本地文件系统中的绝对路径。您可以通过在 'mcp_doctl' 目录下运行 'pwd' 命令获取当前路径,然后拼接得到完整的命令路径。
- '"args"': 启动参数,本服务器无需额外参数,保持空列表 '[]' 即可。
注意: 请务必将 '"/path/to/goose_mcp"' 替换为您克隆 'goose_mcp' 仓库的实际本地路径。
基本使用方法
- 启动 MCP 客户端: 启动您使用的 MCP 客户端,例如 Goose。
- 配置服务器: 在 MCP 客户端中配置 'doctl' 服务器,填入上述 JSON 配置信息。
- 调用工具: 在 MCP 客户端中,您可以使用 'doctl.工具名' 的形式调用 'mcp_doctl' 提供的工具。例如,使用 'doctl.create_droplet' 创建 Droplet,使用 'doctl.list_droplets' 列出 Droplet。
- 查看帮助: 您可以通过 'doctl.help()' 查看所有可用的工具及其参数说明。
通过 'mcp_doctl' 服务器,您可以方便地通过 MCP 客户端以自然语言指令或图形界面操作来管理您的 DigitalOcean 云资源。
信息
分类
开发者工具