mcp-netassist

mcp-netassist

エージェントがあらゆる MCP クライアントで自分で実行できる、ネットワークとプロキシの診断ツールです。Claude Code、Cursor、Claude Desktop、DSH に対応しています。

こんなときに役立ちます

• MCP クライアントから GitHub や npm に接続できず、エージェントに原因を調べてほしいとき
• ホストごとにプラグインを使い分けるのではなく、どのエディターでも同じ診断を実行したいとき
• エージェントがネットワークの問題を推測するだけなのにうんざりしているとき

スコアバッジがそのまま示しています。このサーバーは Glama に掲載され、メンテナーによる所有権の申告があり、ツール定義の評価は A です。Windows が必要です。詳しくは「プラットフォーム」をご覧ください。

あらゆる MCP クライアントで使えます。Claude Code、Claude Desktop、Cursor、Reasonix、CodeWhale、DeepSeek Harness に対応しています。エージェントに接続して、「GitHub に接続できますか？」「プロキシが動かないのはなぜですか？」「何を変更すればよいですか？」と尋ねれば、推測に頼る必要はありません。

中国のネットワーク環境を想定して構築されています。不安定な GitHub、設定が不完全なプロキシ、プロキシと競合する hosts ファイル、そしてシステムプロキシを気付かれないように上書きする TUN モードに対応します。

現時点では Windows のみです。チェックには PowerShell を使用します。プロトコル層は移植可能で、次のステップとして POSIX バックエンドを追加するのが自然です。

フィードバック

インストール数はダウンロード数に表れますが、これが役に立ったかどうかはわかりません。使っている方は、星を付けるよりも、実際に試したタスクについて一言いただけると参考になります。特に、うまくいかなかった場合はぜひお知らせください。そうしたケースは報告されないことが多いためです。

• 何をしようとしていたか
• 期待どおりに動いたか
• 何が不足していたか、または何が間違っていたか

イシューでお知らせください。すでに不具合がある場合は、通常のバグ報告を作成してください。

プラットフォーム

Windows、Linux、macOS に対応しています。 チェックには各プラットフォーム固有の仕組みを使います。

	Windows	Linux / macOS
DNS / TCP / HTTPS	PowerShell (System.Net)	Node dns、net、https
プロキシ設定	レジストリの ProxyEnable / ProxyServer	HTTP_PROXY / HTTPS_PROXY / ALL_PROXY / NO_PROXY
hosts ファイル	%WINDIR%\System32\drivers\etc\hosts	/etc/hosts
TUN アダプター	Get-NetAdapter	ip link / ifconfig（利用可能な場合）

表現もプラットフォームに合わせています。Windows 以外にはシステム全体のプロキシ切り替え機能がないため、存在しない設定をでっち上げるのではなく、レポートでは「プロキシ環境変数」と記載します。

MCP_NETASSIST_PLATFORM=posix または win32 を設定すると、分岐を強制できます。テストスイートではこれを使って、同じマシン上で両方の実装をテストしています。

ツール

ツール	わかること
net_github_status	現在 github.com に接続できますか？ DNS、TCP 443、HTTPS ステータスとレイテンシを確認します
net_proxy_status	システムではどのプロキシが使われていますか？ 無効化後も値が残っている場合を含め、レジストリ設定と環境変数を確認します
net_proxy_probe	動作しているローカルプロキシのポートはどれですか？（既定値：10808、10809、7890、7897、8888、1080）
net_diag	任意のホストについて、DNS → TCP → HTTP ステータスの全経路を確認します
net_hosts_check	hosts ファイルに固定されている GitHub のエントリーはどれですか？
net_dns_compare	AliDNS、DNSPod、Cloudflare、Google に同じ問い合わせをして比較します。システムのリゾルバーが古い応答を返していませんか？
net_registry_check	npm が使用するように設定されているレジストリに実際に接続できますか？ 設定先と公式レジストリの両方を確認します
net_doctor	プロキシ、ポート、TUN、GitHub、hosts、DNS サーバー間の一致と npm レジストリを含む、事前チェックのすべてを実行し、変更すべき内容を具体的に提案します

このサーバーの中心となるのが net_doctor です。他のツールは問題の内容を教えてくれますが、こちらは対処方法を教えてくれます。

✔ System proxy: 127.0.0.1:10808
✔ Proxy port 10808 responding
✔ GitHub reachable (HTTP 200, 312 ms)
⚠ TUN-style adapter detected: clash
   Under TUN mode the system proxy setting is usually ignored — the two can fight each other.
✔ hosts file clean (no GitHub entries)

Suggested fix:
- Under TUN mode, clear the Windows system proxy (or exclude github.com) so traffic is not double-handled.

セットアップ

Claude Desktop / Cursor / JSON 設定に対応した任意のクライアント：

{
  "mcpServers": {
    "netassist": {
      "command": "npx",
      "args": ["-y", "github:Edge-Echo/mcp-netassist"]
    }
  }
}

ビルド済みの lib/ はリポジトリに含まれているため、GitHub から利用する場合はビルド手順が不要です。

npm から：

{
  "mcpServers": {
    "netassist": {
      "command": "npx",
      "args": ["-y", "mcp-netassist"]
    }
  }
}

Claude Code：

claude mcp add netassist -- npx -y github:Edge-Echo/mcp-netassist

DeepSeek Harness（ネイティブプラグインと同じ診断機能に加え、net_doctor をエージェントツールとして提供します）：

dsh plugin --profile web add dsh-netassist

チェックアウトから：

{
  "mcpServers": {
    "netassist": { "command": "node", "args": ["/path/to/mcp-netassist/lib/server.js"] }
  }
}

コンテナー内：

docker build -t mcp-netassist .
docker run -i --rm mcp-netassist

このイメージは、ディレクトリの一覧表示で使用されるイントロスペクションチェックにも利用されます。Linux コンテナー内ではサーバーが起動し、initialize / tools/list に通常どおり応答しますが、ツールの実行には Windows PowerShell が必要で、利用できない場合はその旨が通知されます。

設計上の注意

• 読み取り専用です。 設定の書き込み、プロキシの変更、hosts ファイルの編集を行うツールはありません。状況を報告して提案します。判断するのはユーザーです。
• インジェクションに安全です。 すべてのユーザー入力は、補間テキストではなく Base64 として PowerShell の境界を越えます。
• 隠れた状態はありません。 呼び出しごとに独自のチェックを実行し、呼び出し間で結果をキャッシュしないため、常に最新の結果が得られます。
• 依存関係は 2 つ（@modelcontextprotocol/sdk、zod）で、ネイティブモジュールはありません。

関連項目

dsh-toolkit family の一部です。同じ診断機能は DeepSeek Harness プラグイン（dsh-netassist）としても提供されており、net_doctor がエージェントツールとして追加されます。

ライセンス

MIT