MCP サーバー／CLI を npm 公開せずに GitHub 直接指定（npx github:）で配布する

npm publish がアカウントの 2FA 制約・組織権限などで止まっているとき、配布導線を npx -y github:<owner>/<repo> に切り替えて利用者を待たせない手順。パッケージ名は温存し、 将来 npm に戻せる形にする。

前提

• リポジトリが Public で、package.json に bin がある（npx github: は bin を実行する）
• 利用者向け導線が複数箇所にある（LP の表示、コピーボタン、README、init サブコマンドが書く .mcp.json、テストの期待値）

手順

1. 置換対象を「利用者が実行するコマンド文字列」だけに限定する
   • claude mcp add <name> -- npx -y <pkg> → claude mcp add <name> -- npx -y github:<owner>/<repo>
   • npx -y <pkg> init|search|get|report → npx -y github:<owner>/<repo> ...
   • JSON 形式 "args": ["-y", "<pkg>"] → "args": ["-y", "github:<owner>/<repo>"]
   • package.json の name / bin は変えない（npm 復帰の余地。UA 文字列やファイル名も温存）
2. LP は表示とコピーボタンの両方を直す。<code> の中身と CopyButton text= が別々に書かれていると片方だけ直って 「表示とコピー内容がずれる」事故になる。grep で両方を数えてから直す
3. テストの期待値を「配布元の指定が入っているか」に変える（html.includes("github:<owner>/<repo>")）。 パッケージ名で検査していると、置換後も旧記述が残っているのを見逃す
4. 完了条件の grep（0件が正）: grep -rn "npx -y <pkg>" <lp>/src <lp>/test <lp>/e2e <cli>/README.md <cli>/bin

検証（全部 AI 側で実行する）

• node --check <cli>/bin/*.mjs
• init を空ディレクトリで実走し、生成された .mcp.json を読み戻す。2回目は「登録済み・無変更」、既存の他エントリを壊さないことも見る
• LP は build 後にローカル起動して HTML を curl し、新コマンドの件数と旧コマンド 0件を数える。テストも通す
• 利用者と同じ経路 npx -y github:<owner>/<repo> init を実走して .mcp.json の中身を見る

落とし穴

• ローカルを直しただけでは利用者に届かない。npx github: は GitHub の default branch を取得するので、 cli 側の変更は push までが1タスク。実走で旧値が出たら「push 漏れ」をまず疑う
• 別セッション・別担当が先に同じ修正を push していることがある。push 前に git fetch し、 git diff -w HEAD origin/main が空なら push しない（改行コード差だけで「差分あり」に見える）
• 配布内容の確認は raw.githubusercontent.com/<owner>/<repo>/<branch>/bin/<file> を cache-buster 付きで直接照会する。 npx は github: 指定をキャッシュするので、キャッシュ削除ができない環境では実走結果が古いことがある
• 本番 LP の確認は同じ URL を叩き直さない。クエリを変えて X-Vercel-Cache が STALE でないことを見る

期待効果

利用者は npm の状況に関係なく npx -y github:<owner>/<repo> で即導入できる。npm 公開が通ったら、 同じ置換を逆向きに1回やるだけで戻せる。