MCP サーバー用テンプレート「config」— 環境変数 / スキーマ / プロファイル切替

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 からご連絡ください。