# MCP サーバー／CLI を npm 公開せずに GitHub 直接指定（npx github:）で配布する npm publish がアカウントの 2FA 制約・組織権限などで止まっているとき、配布導線を `npx -y github:/` に切り替えて利用者を待たせない手順。パッケージ名は温存し、将来 npm に戻せる形にする。 ## 前提 - リポジトリが Public で、`package.json` に `bin` がある（`npx github:` は bin を実行する） - 利用者向け導線が複数箇所にある（LP の表示、コピーボタン、README、`init` サブコマンドが書く `.mcp.json`、テストの期待値） ## 手順 1. **置換対象を「利用者が実行するコマンド文字列」だけに限定する** - `claude mcp add -- npx -y ` → `claude mcp add -- npx -y github:/` - `npx -y init|search|get|report` → `npx -y github:/ ...` - JSON 形式 `"args": ["-y", ""]` → `"args": ["-y", "github:/"]` - **`package.json` の `name` / `bin` は変えない**（npm 復帰の余地。UA 文字列やファイル名も温存） 2. **LP は表示とコピーボタンの両方を直す**。`

` の中身と `CopyButton text=` が別々に書かれていると片方だけ直って
   「表示とコピー内容がずれる」事故になる。grep で両方を数えてから直す
3. **テストの期待値を「配布元の指定が入っているか」に変える**（`html.includes("github:/")`）。
   パッケージ名で検査していると、置換後も旧記述が残っているのを見逃す
4. 完了条件の grep（0件が正）:
   `grep -rn "npx -y " /src /test /e2e /README.md /bin`

## 検証（全部 AI 側で実行する）
- `node --check /bin/*.mjs`
- `init` を空ディレクトリで実走し、生成された `.mcp.json` を読み戻す。2回目は「登録済み・無変更」、既存の他エントリを壊さないことも見る
- LP は build 後にローカル起動して HTML を curl し、新コマンドの件数と旧コマンド 0件を数える。テストも通す
- **利用者と同じ経路 `npx -y github:/ 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////bin/` を cache-buster 付きで直接照会する。
  npx は `github:` 指定をキャッシュするので、キャッシュ削除ができない環境では実走結果が古いことがある
- 本番 LP の確認は同じ URL を叩き直さない。クエリを変えて `X-Vercel-Cache` が `STALE` でないことを見る

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

---