mcp-hetzner

MCP Hetzner Go

用于与 Hetzner Cloud API 交互的 Go Model Context Protocol（MCP）服务。

🌟 推荐项目

🎉 现已列入官方 Awesome HCloud 名单！

与 Claude Desktop 配合使用

在 ~/Library/Application Support/Claude/claude_desktop_config.json 中创建文件，并填入以下内容：

{
  "mcpServers": {
    "hetzner": {
      "command": "<your path to golang MCP server go executable>",
      "env": {
        "HCLOUD_TOKEN": "YOUR-HCLOUD-TOKEN"
      }
    }
  }
}

🛠 构建客户端

npm --prefix ./client i
npm --prefix ./client run build

🖥 构建服务端

go mod init github.com/MahdadGhasemian/mcp-hetzner-go
go mod tidy
go build -o mcphetzner
# go run .

🚀 运行客户端

node ./client/build/index.js ./mcphetzner

⚠️ 使用限制

该服务支持两种操作模式，由配置控制：

• 只读模式：仅允许 GET 和 LIST 操作。
• 读写模式：允许 GET、LIST 以及 CREATE/UPDATE/DELETE 操作。

默认情况下，服务以只读模式启动。
若要启用写入操作（例如创建、更新或删除资源），必须显式设置配置标志以启用读写模式。

警告：启用写入模式后，客户端可以修改你的 Hetzner Cloud 资源。
请确保了解相关影响，并设置适当的访问控制。

切换模式

编辑配置，或在启动时传入相应的环境变量/标志：

• 只读（默认；适合安全地检查和监控）：

  ./mcphetzner --restriction=read_only
  

• 读写（谨慎使用！）：

  ./mcphetzner --restriction=read_write
  

✅ 代码检查

# install golangci-lint and then run:
golangci-lint run

🔍 检查器

npx @modelcontextprotocol/inspector

🗺 路线图

• 实现以下资源的所有 GET 和 LIST 操作：

  • 证书
  • SSH 密钥
  • 位置
  • 数据中心
  • 防火墙
  • 浮动 IP
  • 服务器
  • 镜像
  • ISO
  • 放置组
  • 主 IP
  • 服务器类型
  • 负载均衡器
  • 负载均衡器类型
  • 网络
  • 卷
  • 定价

• 添加配置标志或设置以：

  • 启用 read_only 模式（仅 GET/LIST）
  • 启用 read_write 模式（GET/LIST + CREATE/UPDATE/DELETE）

• 实现写入操作（创建/更新）：

  • 证书
  • SSH 密钥
  • 防火墙
  • 浮动 IP
  • 服务器
  • 镜像
  • 放置组
  • 主 IP
  • 负载均衡器
  • 网络
  • 卷

• 为受支持的资源添加删除功能