MCP サーバーが1本も起動しない原因は、起動前の 40 行で特定できます

#!/usr/bin/env node
import { readFileSync, accessSync, constants } from "node:fs";
import { delimiter, join } from "node:path";
 
const file = process.argv[2];
if (!file) { console.error("usage: node mcp-preflight.mjs <settings.json>"); process.exit(2); }
 
let raw, cfg;
try { raw = readFileSync(file, "utf8"); }
catch (e) { console.error(`FATAL 読み込み失敗: ${e.message}`); process.exit(2); }
try { cfg = JSON.parse(raw); }
catch (e) {
  console.error(`FATAL JSON として読めません: ${e.message}`);
  const m = /position (\d+)/.exec(e.message);
  if (m) console.error(`      → ${raw.slice(0, Number(m[1])).split("\n").length} 行目付近を確認してください`);
  process.exit(2);
}
 
const servers = cfg.mcpServers ?? {};
const names = Object.keys(servers);
if (names.length === 0) { console.error("FATAL mcpServers が空です"); process.exit(2); }
 
function which(cmd) {
  if (cmd.includes("/")) { try { accessSync(cmd, constants.X_OK); return cmd; } catch { return null; } }
  for (const dir of (process.env.PATH ?? "").split(delimiter)) {
    try { accessSync(join(dir, cmd), constants.X_OK); return join(dir, cmd); } catch {}
  }
  return null;
}
 
// JSON は同名キーを黙って上書きするため、生テキスト側で重複を数える
const declared = [...raw.matchAll(/^[\t ]*"([A-Za-z0-9_.-]+)"[\t ]*:[\t ]*\{/gm)].map((m) => m[1]);
const dupes = [...new Set(declared.filter((n) => names.includes(n) && declared.filter((x) => x === n).length > 1))];
for (const d of dupes) console.log(`WARN ${d} が複数回宣言されています（最後の1つだけが読まれます）`);
 
let bad = 0;
for (const name of names) {
  const s = servers[name] ?? {};
  const errs = [];
  if (!/^[A-Za-z0-9_-]+$/.test(name)) errs.push("サーバー名に使えない文字が含まれています");
  if (s.url) {
    if (!/^https?:\/\//.test(s.url)) errs.push(`url が http(s) で始まっていません: ${s.url}`);
  } else if (typeof s.command !== "string" || s.command.length === 0) {
    errs.push("command が未設定です（url も無い場合は必須）");
  } else if (!which(s.command)) {
    errs.push(`command が PATH 上に見つかりません: ${s.command}`);
  }
  if (s.args !== undefined && !Array.isArray(s.args)) errs.push("args が配列ではありません");
  for (const [k, v] of Object.entries(s.env ?? {})) {
    if (typeof v !== "string") { errs.push(`env.${k} が文字列ではありません`); continue; }
    const ref = /^\$\{?([A-Z0-9_]+)\}?$/.exec(v);
    if (ref && !process.env[ref[1]]) errs.push(`env.${k} が参照する ${ref[1]} が未設定です`);
    if (v === "") errs.push(`env.${k} が空文字です`);
  }
  if (errs.length) { bad++; console.log(`NG  ${name}`); for (const e of errs) console.log(`      - ${e}`); }
  else console.log(`OK  ${name}`);
}
console.log(`---\n${names.length} 件中 ${names.length - bad} 件が起動可能な設定です`);
process.exit(bad ? 1 : 0);

OK  filesystem
OK  sqlite
NG  internal-api
      - url が http(s) で始まっていません: localhost:8931/mcp
NG  notes
      - args が配列ではありません
      - env.NOTES_TOKEN が参照する NOTES_TOKEN が未設定です
NG  search
      - env.SEARCH_ENDPOINT が空文字です
---
5 件中 2 件が起動可能な設定です

FATAL JSON として読めません: Expected double-quoted property name in JSON at position 156 (line 6 column 5)
      → 6 行目付近を確認してください

WARN notes が複数回宣言されています（最後の1つだけが読まれます）
NG  notes
      - command が PATH 上に見つかりません: bunx
---
1 件中 0 件が起動可能な設定です