Gridscale MCP

Gridscale MCP

这是一个 MCP 服务，可让 AI 模型 与 Gridscale API 交互。

你可以将它与 5ire 等工具搭配使用，让你的大模型按需配置基础设施。

注意

使用此程序的后果由你负责。你应仅在空的 Gridscale 项目中使用此程序， 以免 AI 模型造成任何损害，例如删除你的生产数据库。

功能（工具和资源）

使用此 MCP 服务，你可以使用以下工具和资源：

类型	名称	备注	支持情况	需要支持
工具	create_ip		是
工具	delete_ip		是
工具	create_storage	并非支持所有参数	部分支持
工具	create_server		否	是
工具	create_network		否	是
资源	get_storage_templates		是

如果你想参与贡献，可以尝试添加上述缺少的工具或资源之一。

构建 + 安装

要构建此程序，你需要一个 Go 环境。

推荐使用 make：

make build

这会在项目目录中生成一个名为 gridscale-mcp 的二进制文件。

安装

将二进制文件安装到 $PATH 中的位置会更方便，例如 Linux 上的 /usr/bin。

你可以使用 make 来完成：

# Install
make install

# Uninstall
make uninstall

用法

注意

使用此程序的后果由你负责。你应仅在空的 Gridscale 项目中使用此程序， 以免 AI 模型造成任何损害，例如删除你的生产数据库。

前提条件

你需要：

• 已构建 gridscale-mcp。请先按照构建部分中的步骤构建程序。
• Gridscale API 的公共 API 凭据

在 MCP 客户端中使用

运行此服务需要两个参数：

gridscale-mcp --user-key <your-gs-user-key> --user-token <your-gs-user-token>

我推荐使用 5ire 作为桌面客户端，与大模型和此 MCP 服务交互。 你需要自行设置大模型（例如 Gemini）。

在 5ire 中，MCP 服务可按如下方式配置为工具：

{
  "name": "Gridscale",
  "key": "gridscale",
  "command": "gridscale-mcp",
  "args": [
    "--user-key",
    "...",
    "--user-token",
    "..."
  ]
}

调试

你可以像与任何其他 API 服务通信一样，直接与 MCP 服务通信。

MCP Inspector 是一款很实用的工具。

如果你已安装 Node.js，只需运行：

make inspect