共通ルールと違う運用

サンプルは JavaScript（.mjs）で書く

• 上書きする見出し: 「コーディングルール」＞「使用言語（Node / Bun）」
• 違い: 共通ルールは ts を優先するが、docs/samples/ のサンプルは .mjs にする。テストとツールは共通ルールどおり TypeScript
• 理由: 読者は「JavaScript の文法は知っている」前提で、MCP の側だけを扱う資料だから（計画の論点 1）。TypeScript 版は付録として別に足す

テスト

直列で流す

• --test-concurrency=1 を必ず付ける。HTTP のテストが待ち受けポートを使うので、並列にすると取り合って落ちる
• テストごとにポートを分けてある（3397〜3399）。足すときは重ならない番号にする

ランチャで対象を渡すときは配列を組む

• Windows PowerShell 5.1 では、1 件だけの配列が代入で文字列に潰れる。そこへ @変数 でスプラッティングすると何も渡らず、node --test も bun test もカレント配下を探し始める
• このプロジェクトで 2 回起きた。1 回目は node がプロジェクトの外のファイルまで実行し、2 回目は bun が node_modules の中のテストを 700 件ほど走らせた
• $args = @('test') + $targets のように配列を組んでから渡し、要素数を確かめる

サンプル

タスク（09 章）は後片付けを書かないと終わらない

• InMemoryTaskStore は TTL のタイマーを持つ。transport.onclose で taskStore.cleanup() を呼ばないと、接続が切れてもプロセスが残る
• capabilities.tasks は自動では付かない。McpServer の第 2 引数で明示する
• callToolStream がタスクの作成を知らせるメッセージの型は taskCreated（task ではない）

C#（付録 A3）は BOM を出さない

• 出力の文字コードは new UTF8Encoding(false)。既定の UTF-8 は先頭に BOM を付け、ホストが最初の行を JSON として読めなくなる