Trustabl Probe

Trustabl Probe MCP サーバー

コーディングエージェントに Trustabl Probe を提供します。 エージェントのツール向けにネットワーク許可リストのドラフトを作成し、ネットワークを遮断したサンドボックスでツールを実行して、実行時にのみ発生する問題を検出します。各検出結果には修正のヒントが付いており、エージェントが修正を適用するため、モデルや API キーは必要ありません。

ツール

ツール	機能	何かを変更しますか？
probe_check_setup	Probe バイナリ、Docker、サンドボックスイメージの準備状況、サンドボックスで実行可能な言語、各不足項目を修正するための正確なコマンドを報告します。	いいえ
probe_install	Probe バイナリをダウンロードし（チェックサム検証済み）、サンドボックスイメージを取得します。Docker、OpenShell、Python の場合は、注意事項とともに実行するコマンドのみを返します。	はい。下記を参照
probe_scan	ツールのディレクトリをスキャンし、準備状況スコア、ネットワーク許可リストのドラフト、重大度の高い順に並べた修正のヒント付き検出結果を返します。	スキャンしたディレクトリに 4 つのレポートファイルを書き込みます

静的解析とサンドボックス

• 静的解析ではコードを読み取り、タイムアウトの欠落、ハードコードされた認証情報、フィルタリングされていないツール出力などの問題を検出します。また、コードをもとにネットワーク許可リスト（OpenShell ネットワークポリシー）のドラフトを作成します。常に実行され、追加の要件はありません。
• サンドボックスでは、ネットワークを遮断した状態でツールも実行し、クラッシュ、依存関係の不足、接続試行の遮断を検出します。Docker（または NVIDIA OpenShell）が必要です。デフォルトの sandbox: "auto" では、実行環境の準備ができていれば毎回実行されます。破壊的な操作（支払い、削除、ネットワークへの書き込みなど）を行うように見えるツールは、allow_write_tools: true を指定しない限り実行されません。

Docker では Python、JavaScript/TypeScript、Go、Ruby を実行できます。OpenShell イメージでは Python と Node を実行できます。シェルスクリプトは常に静的解析のみを行います。

インストール

Node.js 18 以降が必要です。Docker は任意ですが、サンドボックスを利用できるようになります。

このサーバーはすべての Probe リリースに trustabl-probe-mcp-<version>.tgz として同梱されています。以下の例では v0.2.4 を使用しています。最新リリースを使用してください。

Cursor（.cursor/mcp.json）：

{
  "mcpServers": {
    "trustabl-probe": {
      "command": "npx",
      "args": ["-y", "https://github.com/trustabl/agent-network-access-probe/releases/download/v0.2.4/trustabl-probe-mcp-0.2.4.tgz"]
    }
  }
}

Claude Code：

claude mcp add trustabl-probe -- npx -y https://github.com/trustabl/agent-network-access-probe/releases/download/v0.2.4/trustabl-probe-mcp-0.2.4.tgz

Claude Desktop： リリースから trustabl-probe-mcp-<version>.mcpb をダウンロードして開くとインストールできます。または、Cursor の例と同じ command と args を claude_desktop_config.json の mcpServers に指定してください。

続いて、エージェントに probe_check_setup の実行を依頼してください。

このツールがマシン上で変更する内容

• サーバーと同じリリースから Probe バイナリをダウンロードし、リリースの checksums.txt と照合してから ~/.trustabl-probe/<version>/ に保存します。不一致の場合は処理を中止します。
• probe_install の実行時、またはサンドボックスを初めて実行するときに、サンドボックスイメージ（python:3-slim、node:20-slim、golang:1.25-alpine、ruby:3-slim）を取得します。
• スキャンしたディレクトリに network_policies.draft.yaml、probe.findings.json、probe.profile.json、autofix-attestation.json を書き込みます。
• Docker、OpenShell、Python 自体をインストールすることはありません。実行するコマンドを返すため、エージェントは実行前にユーザーに確認する必要があります。Docker Desktop のインストールには管理者権限が必要で、Windows では再起動が必要な場合があります。また、大企業での利用には有料サブスクリプションが必要です。

プライバシーポリシー

Trustabl のプライバシーポリシー：https://trustabl.ai/privacy/

このサーバーによるデータの取り扱い：

• 収集： ありません。テレメトリーの送信も、モデルへの呼び出しも行いません。
• コード： お使いのマシン上で読み取って分析し、アップロードすることはありません。 アテステーション署名は無効になっているため、透明性ログに記録されることもありません。
• ネットワークアクセス： Probe のリリースをダウンロードするための GitHub、サンドボックスイメージを取得するための Docker Hub、および Python ツールが依存関係を宣言している場合に、サンドボックスの実行前にそれらをインストールするための PyPI のみです。テスト対象のツールはネットワークがブロックされた状態で実行されます。
• 保存： Probe バイナリは ~/.trustabl-probe/ にキャッシュされ、4 つのレポートファイルはスキャン対象のディレクトリに書き込まれます。どちらもいつでも削除できます。
• 第三者： Trustabl を含め、他者と共有される情報はありません。
• お問い合わせ先： https://github.com/trustabl/agent-network-access-probe/issues

設定

変数	デフォルト	目的
PROBE_VERSION	サーバーに付属するリリース	代わりに使用する Probe のリリース。例：v0.2.3 または latest。v0.2.3 以降が必要です。
PROBE_BIN		ローカルにある Probe ビルドのパス。ダウンロードを省略します
GITHUB_TOKEN		PROBE_VERSION が latest の場合に、GitHub の匿名利用時のレート制限を回避するためだけに使用します

開発

mcp/ から実行します：

cd server && npm ci && npm run build   # bundles to dist/index.js, which is committed
node test/smoke.mjs                    # handshake, tools/list, setup check
SMOKE_SCAN=1 node test/smoke.mjs       # also a static scan of test/fixture with the released Probe
PROBE_BIN=/path/to/autofix node test/smoke.mjs   # the same scan with a local Probe build

チェックアウト版のバージョンは 0.0.0 で、最新の Probe リリースを使用します。リリースワークフローは、サーバーのパッケージ化時に実際のバージョンを設定します。

ライセンス

Probe と同じく Apache-2.0 です。