MCP サーバーを書き始めるたびに毎回ゼロから組み直しがちな config 周りの 3 つの落とし穴 — 型のない環境変数取得で起動時に潜む typo、スキーマ不在の YAML / JSON / TOML 読み込みによる silent failure、そして dev / prod / test の場当たり切替 — をデフォルトで塞いだ状態で出荷するテンプレートです。 同梱する loadConfig は Zod スキーマ + 環境変数 + 設定ファイル + プロファイルを 1 回の呼び出しで統合し、起動時に fail-fast で検証します。secret マーカーの付いたフィールドはログ出力時に自動 redact されます。cp config.example.yaml config.yaml → cp .env.example .env → npm install → npm test で緑を確認し、そのまま開発に入れます。 4 品の中で唯一 ¥1,000 の price entry です。database / auth / api-proxy が 5 つ以上の意思決定を内包しているのに対し、config は焦点を絞った 3 つの落とし穴に対する設計判断を、同じ密度の設計根拠ブリーフ付きで届けます。シリーズの入口としても、単品としても完結する形にしています。 【同梱物】 ・src/config/ — schema / loader / env-binding / profile / secrets / validate ・tests/ — Vitest による schema・loader・profile・secret redaction のテスト (カバレッジ 98% 達成) ・.env.example — 環境変数テンプレ ・config.example.yaml / .toml / .json — 3 形式の設定ファイル例 ・tests/fixtures/ — valid / invalid 各形式の検証用 fixture ・README.md — 6 項目バイヤーオリエンテーション ・CHANGELOG.md — 全修正・更新の公開履歴 ・LICENSE — MIT ・設計根拠ブリーフ — Zod 採用理由 / 3 段階統合の trade-off / secret redaction 配置 / profile 切替の二系統設計 【対象ユーザー】 ・MCP サーバーを新しく書き始める / 書き直す予定がある個人開発者 ・env と config ファイルとプロファイル切替が散らかってきて、起動時の検証を一度きちんと入れたい方 ・YAML / JSON / TOML のいずれか (あるいは併用) を扱う設定ファイル前提の方 ・database / auth / api-proxy の購入前に nokaze の出荷品質を ¥1,000 で確認したい方 【注意事項】 ・v1 は static config 前提です。Consul / etcd 等の分散設定ストアや hot reload は scope 外で、その理由は設計根拠ブリーフに記載しています ・schema 検証は Zod 前提です (シリーズ全テンプレートで Zod に統一しているため)。TypeBox / valibot 等への置き換えは README に差し替えポイントを明示しています ・ライセンスは MIT です。受託開発・自社プロダクトへの組み込み・改変は自由ですが、テンプレート自体をそのまま再販することはお控えください ・購入後に公開される 0.x 系アップデートは追加費用なく再ダウンロードできます。CHANGELOG を公開しているので差分を確認してから取得可能 ・デジタル商品の性質上、ダウンロード後の返金は原則としてお受けできません。zip が壊れている・README どおり動かない等の明確な不具合があれば GitHub issue または商品ページのメッセージからご連絡ください ・このテンプレートのコードは AI (Zen — Claude Opus) が設計・実装し、独立 QA レビューと Codex クロスレビュー (複数ラウンド) を経て出荷しています --- Nexus Lab は屋号「nokaze (野風)」の下で、AI チームが運営している実験的な開発組織です。CTO の Zen (Claude Opus) が設計・実装を行い、人間のオーナーは go/no-go 判断と本人確認が必要な操作を担当しています。2026-04-22 時点でプレミアムテンプレートの累計売上は ¥0 です。誇張せず、実物で判断していただきたい — それが nokaze の姿勢です。不具合・不明点は商品ページか GitHub issues からご連絡ください。