fix(servers): 改用 location 取代已被 Hetzner 移除的 datacenter 欄位

.coderabbit.yaml

@@ -0,0 +1,10 @@
+# yaml-language-server: $schema=https://storage.googleapis.com/coderabbit_public_assets/schema.v2.json
+language: "zh"
+tone_instructions: "一律使用繁體中文（台灣正體用語）撰寫審查意見與回覆。"
+reviews:
+  auto_review:
+    base_branches:
+      - "^main$"
+    # release-please 自動開的 release PR（標題固定 "chore(main): release X.Y.Z"）純版號/CHANGELOG，跳過審查
+    ignore_title_keywords:
+      - "chore(main): release"

README.md

@@ -48,6 +48,8 @@ Storage Box tools call `api.hetzner.com/v1` (unified API), while all other tools
 
 ## Available Tools (40 total)
 
+⚠️ marks destructive or hard-to-reverse operations.
+
 ### Servers (7)
 
 | Tool | Description | ⚠️ |

docs/index.html

@@ -229,6 +229,7 @@ <h1>Hetzner <span>MCP</span> Server</h1>
 
     <div class="section">
       <h2 data-i18n="section-tools">Tools</h2>
+      <p style="font-size:13px;color:var(--muted);margin:-8px 0 16px;" data-i18n="tools-note">⚠ marks destructive or hard-to-reverse operations.</p>
       <div class="categories">
 
         <div class="category">
@@ -373,6 +374,7 @@ <h2 data-i18n="section-setup">Quick Setup</h2>
     "stat-endpoints": "API Endpoints",
     "stat-transport": "Transport",
     "section-tools": "Tools",
+    "tools-note": "⚠ marks destructive or hard-to-reverse operations.",
     "cat-servers": "Servers",
     "cat-servers-desc": "Create, power on/off/reboot, and delete cloud servers.",
     "cat-ssh": "SSH Keys",
@@ -401,6 +403,7 @@ <h2 data-i18n="section-setup">Quick Setup</h2>
     "stat-endpoints": "API 端點",
     "stat-transport": "傳輸協定",
     "section-tools": "工具",
+    "tools-note": "⚠ 標示破壞性或難以復原的操作。",
     "cat-servers": "伺服器",
     "cat-servers-desc": "建立、開關機、重新開機、刪除雲端伺服器。",
     "cat-ssh": "SSH 金鑰",
@@ -429,6 +432,7 @@ <h2 data-i18n="section-setup">Quick Setup</h2>
     "stat-endpoints": "API エンドポイント",
     "stat-transport": "トランスポート",
     "section-tools": "ツール",
+    "tools-note": "⚠ は破壊的または元に戻しにくい操作を示します。",
     "cat-servers": "サーバー",
     "cat-servers-desc": "クラウドサーバーの作成、電源操作、再起動、削除。",
     "cat-ssh": "SSH キー",
@@ -457,6 +461,7 @@ <h2 data-i18n="section-setup">Quick Setup</h2>
     "stat-endpoints": "API 엔드포인트",
     "stat-transport": "전송 방식",
     "section-tools": "도구",
+    "tools-note": "⚠ 는 파괴적이거나 되돌리기 어려운 작업을 나타냅니다.",
     "cat-servers": "서버",
     "cat-servers-desc": "클라우드 서버 생성, 전원 켜기/끄기, 재시작, 삭제.",
     "cat-ssh": "SSH 키",

src/api.ts

@@ -283,9 +283,11 @@ export function createPaginatedFetch(requestFn: PaginatedRequestFn) {
   };
 }
 
-// I-5: Test-only reset hook for clearing cached clients between tests.
-// Throws unless NODE_ENV === "test" — catches both explicit "production" and the
-// common MCP production case where NODE_ENV is simply not set.
+/**
+ * @internal
+ * Test-only reset hook for clearing cached singleton clients between test runs.
+ * Throws in any non-test environment — do NOT call from production code.
+ */
 export function __resetClientsForTesting(): void {
   if (process.env.NODE_ENV !== "test") {
     throw new Error("__resetClientsForTesting must not be called in production");

src/index.ts

@@ -16,6 +16,7 @@ import { registerStorageBoxTools } from "./tools/storage-boxes.js";
 import { registerVolumeTools } from "./tools/volumes.js";
 import { registerMetricsTools } from "./tools/metrics.js";
 import { registerServerSshTools } from "./tools/server-ssh.js";
+import { formatStartupError } from "./utils.js";
 
 // Create MCP server instance
 const server = new McpServer({
@@ -54,7 +55,7 @@ async function main(): Promise<void> {
   console.error("Hetzner MCP server running via stdio");
 }
 
-main().catch((error) => {
-  console.error("Server error:", error);
+main().catch((error: unknown) => {
+  console.error("Server error:", formatStartupError(error));
   process.exit(1);
 });