mcpField
H
hetzner

hetzner

本地服务
github.com/lazyants云与基础设施55 天前更新
代码仓库

关于 hetzner

hetzner 是通过 Hetzner Cloud API 管理云资源的 MCP 服务，适合希望从 MCP 客户端检查或操作基础设施的用户。它既可提供全部工具，也可按资源组启动。

主要功能

  1. 01管理服务器、网络和卷
  2. 02管理防火墙、DNS 和负载均衡器
  3. 03按资源组选择服务命令
  4. 04通过资源访问 API 参考

适用场景

  1. 01从 MCP 客户端检查 Hetzner Cloud 基础设施
  2. 02通过 API 操作创建和管理云资源
  3. 03仅加载网络或其他指定资源组

MCP 相关

向 MCP 客户端提供 Hetzner Cloud API 操作，用于管理云资源。支持 stdio 配置，并提供 `reference://hetzner/api` API 参考资源。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "lazyants-hetzner": {
      "command": "npx",
      "args": [
        "-y",
        "@lazyants/hetzner-mcp-server"
      ],
      "env": {
        "HETZNER_API_TOKEN": "<HETZNER_API_TOKEN>",
        "HETZNER_STORAGE_API_TOKEN": "<HETZNER_STORAGE_API_TOKEN>"
      }
    }
  }
}
启动命令npx -y @lazyants/hetzner-mcp-server
需要配置的环境变量
HETZNER_API_TOKEN密钥Hetzner Cloud API token.
HETZNER_STORAGE_API_TOKEN密钥Storage Box API token; falls back to HETZNER_API_TOKEN when omitted.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@lazyants/hetzner-mcp-server4.0.2

工具

185

收录的工具列表 · 更新于 5 天前

参数类型必填说明
namestring否按服务器名称筛选
pageinteger否页码
sortany否排序字段，例如 "id:asc" 或 "name:desc"；传入数组可指定多个排序字段
statusenum否按服务器状态筛选running | initializing | starting | stopping | off | deleting | migrating | rebuilding | unknown
per_pageinteger否每页结果数（最多 50 条）
label_selectorstring否标签筛选器，例如 "env=prod,tier=web"

详细介绍

Hetzner MCP 服务

通过 MCP 客户端管理 Hetzner Cloud 服务器、网络、存储、DNS 和负载均衡器。 需要 Node.js 22.12 或更高版本。

设置

在 Hetzner Cloud Console 中创建 API 令牌。 检查时使用只读令牌；写入操作可能会创建需要付费的资源。

适用于 Claude Code：

claude mcp add --env HETZNER_API_TOKEN=your-token --transport stdio \
  hetzner -- npx -y @lazyants/hetzner-mcp-server

适用于 Claude Desktop 以及接受 mcpServers JSON 的客户端：

{
  "mcpServers": {
    "hetzner": {
      "command": "npx",
      "args": ["-y", "@lazyants/hetzner-mcp-server"],
      "env": { "HETZNER_API_TOKEN": "your-token" }
    }
  }
}

如果要使用单独的 Storage Box 令牌，也请设置 HETZNER_STORAGE_API_TOKEN。 否则，Storage Box 工具会使用 HETZNER_API_TOKEN。

精简服务

默认命令会公开所有工具。若只加载一个资源组，请运行拆分命令：

npx -y -p @lazyants/hetzner-mcp-server hetzner-mcp-networking

在客户端配置中，将 args 替换为：

["-y", "-p", "@lazyants/hetzner-mcp-server", "hetzner-mcp-networking"]

其他组：servers、load-balancers、ips、storage、storage-boxes、config 和 dns。 使用相同的 hetzner-mcp- 命令前缀和令牌配置。

每个服务都会在 reference://hetzner/api 提供 API 参考。 有关版本变更，请参阅 CHANGELOG.md。

发布

维护者说明：发布指南。

许可证

FSL-1.1-MIT。1.1.1 及更早版本仍采用 MIT 许可证。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。