egov-law-mcpが動かない時の対処法｜npx・Node.js・Windows接続エラー

@codeagentjp/egov-law-mcp をClaude CodeやCursorに追加したのに、failed と表示される、ツールが呼ばれない、Windowsだけ動かない。この記事は、そうした接続トラブルを症状別に切り分けるための実務メモです。

セットアップ手順そのものはClaude Codeでe-Gov法令を検索する設定と使い方、サーバーの設計はe-Gov法令MCPの仕組みと安全境界にまとめています。この記事は「設定したのに動かない」場面だけを扱います。

まず結論

前提: 「無言で待つ」のが正常動作

最初に、故障ではないものを故障と誤認しないようにします。

egov-law-mcpはstdio型のMCPサーバーです。ターミナルで直接起動すると、何も表示せずに待機します。

npx -y @codeagentjp/egov-law-mcp

ここでポート番号もバナーも出ませんが、それが正常です。Model Context Protocolのstdio transportは、標準入力からJSON-RPCメッセージを受け取り、標準出力へ応答を書く仕様です。Webサーバーのように「Listening on port 3000」と出ないことを、起動失敗と判断しないでください。

逆に言うと、この単体起動でエラーメッセージが出て終了する場合は、MCPクライアント以前の問題です。以降の症状別の切り分けに進みます。

症状1: claude mcp list で failed になる

Claude Codeで追加したのに接続できない場合、まず状態を確認します。

claude mcp list
claude mcp get egov-law

failed の場合は、Claude Codeがサーバープロセスを起動できていません。原因の大半は、npxがパッケージを解決できないことです。順に確認します。

1. npx単体で起動できるか

npx -y @codeagentjp/egov-law-mcp

無言で待機すれば、サーバー側は正常です。クライアント設定(サーバー名、コマンド、引数のtypo)を見直してください。

2. npxキャッシュが壊れていないか

npm error や ENOTEMPTY、EEXIST のようなエラーで単体起動も失敗する場合は、npxのキャッシュ破損を疑います。npxのキャッシュは ~/.npm/_npx にあります。

rm -rf ~/.npm/_npx
npx -y @codeagentjp/egov-law-mcp

3. レジストリに到達できているか

社内ネットワークやプロキシ環境では、registry.npmjs.org への到達自体が塞がれていることがあります。

npm ping
npm view @codeagentjp/egov-law-mcp version

npm view がバージョン(執筆時点では 0.1.0)を返さないなら、npmレジストリへの経路の問題です。プロキシ設定(npm config get proxy / https-proxy)を確認してください。

症状2: Node.jsのバージョンが古い

egov-law-mcpは engines で Node.js 20以上を要求します。Node 18以前で動かすと、EBADENGINE の警告や、モジュール読み込み時の SyntaxError で落ちることがあります。

node -v

v20.0.0 未満なら、まずここを直します。注意が必要なのは、ターミナルのnodeとMCPクライアントが起動するnodeが別物になっているケースです。nvmやvoltaでターミナル上は20系でも、GUIアプリ(Claude Desktopなど)がPATH解決で古いnodeを拾うことがあります。

その場合は、MCP設定のcommandをnodeの絶対パスで固定するのが確実です。

{
  "mcpServers": {
    "egov-law": {
      "command": "/path/to/node20/bin/npx",
      "args": ["-y", "@codeagentjp/egov-law-mcp"]
    }
  }
}

which npx(macOS/Linux)や where npx(Windows)で、実際に使われるパスを確認できます。

症状3: Windowsで spawn npx ENOENT

Windowsネイティブ環境で最も多い失敗です。Windowsでは npx が .cmd バッチファイルとして解決されるため、MCPクライアントが npx を直接spawnすると見つけられないことがあります。

対処は cmd /c 経由にすることです。Claude Codeなら次で追加し直します。

claude mcp remove egov-law
claude mcp add --transport stdio egov-law -- cmd /c npx -y @codeagentjp/egov-law-mcp

設定JSONを直接書くクライアントでは、次の形にします。

{
  "mcpServers": {
    "egov-law": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@codeagentjp/egov-law-mcp"]
    }
  }
}

WSLを使っている場合は逆に、WindowsのClaude CodeとWSL内のnode環境が別世界である点に注意してください。WSL側にインストールしたnodeは、Windowsネイティブのクライアントからは見えません。クライアントを動かしている側の環境にnode 20+が必要です。

症状4: 接続済みなのにツール呼び出しが失敗する

/mcp で egov-law が接続済みなのに、search_laws や get_article がエラーを返す場合は、MCPサーバーではなく上流のe-Gov法令API側を疑います。

切り分けは、e-Gov APIへ直接アクセスすることです。

curl -s "https://laws.e-gov.go.jp/api/1/lawdata/415AC0000000057" | head -c 300

XMLが返れば、e-Gov側は生きています。返らない場合は、次のどちらかです。

e-Gov法令検索は定期メンテナンスで停止することがあります。深夜帯にツール呼び出しだけ失敗する場合は、まず障害・メンテナンス情報を確認してから自分の環境を疑うと早いです。

また、存在しない条番号や法令IDを指定した場合のエラーは正常動作です。法令IDが不確かな時は、get_article の前に search_laws で正式なlawIdを取り直してください。

症状5: 接続が不安定・起動直後に切断される

接続できたり切れたりする場合は、stdoutの汚染を疑います。stdio型MCPは標準出力をJSON-RPC専用に使うため、そこに余計な文字列が1行混ざるだけでプロトコルが壊れます。

egov-law-mcp本体はログをstderrにしか書きませんが、次のような外側の要因でstdoutが汚れることがあります。

• シェルのrcファイル(.zshrc / .bashrc)に echo があり、非対話シェル起動時にも出力される
• npxをラップした自作スクリプトが進捗メッセージをstdoutに出している
• npmの古いバージョンが通知メッセージをstdoutに混ぜる

それでも直らない時

ここまでで直らない場合は、ログを取ってから報告に進みます。

Claude Codeのデバッグログを見る

claude --debug

デバッグモードで起動すると、MCPサーバーの起動コマンド、stderr出力、接続失敗の理由がログに出ます。egov-law 関連の行を探してください。

GitHub Issueで報告する

再現手順が固まったら、SHAYOUWORLD/egov-law-mcp へIssueを立ててください。次の4点があると調査が早く進みます。

1. OS(Windowsの場合はネイティブかWSLか)
2. node -v と npm -v の出力
3. npx -y @codeagentjp/egov-law-mcp 単体起動の結果
4. MCPクライアント名と設定JSON(そのまま貼り付け)

診断チェックリスト

最後に、この記事の切り分けを上から順に実行できる形でまとめます。

1〜3がすべて通るのにクライアントから繋がらない場合、問題はほぼ確実に設定JSONのtypoか、クライアントが参照しているnode環境の食い違いです。

egov-law-mcpで何ができるかは使い方実演記事、他のMCPサーバーと合わせた選定はMCP厳選カタログを参照してください。法案段階の調査にはhouan-mcpという選択肢もあります。egov-law-mcpに限らないMCP接続全般の切り分けはMCPサーバーが繋がらない時のチェックリストにまとめています。

参考リンク

• npm: @codeagentjp/egov-law-mcp
• GitHub: SHAYOUWORLD/egov-law-mcp
• Claude Code Docs: Connect Claude Code to tools via MCP
• Model Context Protocol: Transports
• e-Gov 法令API（Version 1）の概要
• Node.js: Previous Releases