Maskbreak について
Maskbreakは、クラウドホスティング範囲やTor出口ノードなど、限定的な公開IP情報の照会とAPI状態の確認を行うMCPサーバーです。ローカルのstdio接続とリモートHTTP接続に対応し、VPN、プロキシ、デバイスの情報は対象外です。
主な機能
- 01公開IPv4・IPv6のシグナルを照会
- 02クラウドホスティングとTor出口を識別
- 03リスクスコアと判定を返却
- 04APIの稼働状況、可用性、遅延を確認
- 05ローカルまたはホスト型接続に対応
活用シーン
- 01不正利用の確認時にIP情報を調査
- 02IPがTor出口ノードか確認
- 03Maskbreak APIの状態を確認
MCP 対応
MCPクライアントに`lookup_ip`と`service_status`ツールを提供します。ローカルサーバーはstdioを使い、`https://maskbreak.com/mcp`はStreamable HTTPに対応します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y @sentinelsup/mcpMASKBREAK_API_KEYシークレットMaskbreak API key for your plan's lookup allowance (100,000 a month on the Free plan). Without it, lookups use the rate-limited keyless endpoint. The older SENTINEL_API_KEY name is still read.SENTINEL_BASE_URLAPI base URL override, for testing.ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
2掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| ip | string | はい | 確認する公開 IPv4 または IPv6 アドレス。例:"185.220.101.34" |
詳細
Maskbreak MCP Server
Claude、Cursor、またはその他の MCP クライアントから、公開 IP に関する限定的なインテリジェンス(クラウドホスティング範囲と Tor 出口ノード)を調べます。Maskbreak の不正検知 API を利用しています。ローカルサーバーには Node.js 18+ が必要です。
ツール
| ツール | 機能 |
|---|---|
lookup_ip | 公開 IPv4/IPv6 の照会:known、allow / review / block、リスクスコア、null 許容のシグナル/ネットワークメタデータ。公開フィードの対象はクラウドホスティングと Tor に限定されています。 |
service_status | Maskbreak API のヘルス状態、稼働時間、レイテンシ |
セットアップ
maskbreak.com/signup で無料の API キーを取得できます(Free プランには月 100,000 件の IP 照会が含まれ、カード登録は不要です。有料プランは月 €29 からで、上限が引き上げられます)。キーなしモードでは無料の Web ツールエンドポイントを使用し、呼び出し元 IP ごとに 1 分あたり 12 件、1 日あたり 80 件に制限されます。追加のエンドポイント制限や不正利用防止の制限が適用される場合があります。
どちらのモードもブラウザーにはアクセスしません。VPN/プロキシおよびデバイスの証拠を得るには、これらのツール以外でブラウザー SDK を利用した /v1/evaluate リクエストが必要です。サービス名は判明している場合にのみ利用できます。不明な IP、誤ったシグナル、allow 判定は、安全性の証明にはなりません。
Claude Code
claude mcp add sentinel -e MASKBREAK_API_KEY=sk_live_your_key -- npx -y @sentinelsup/mcp
Claude Desktop
claude_desktop_config.json に追加します:
{
"mcpServers": {
"sentinel": {
"command": "npx",
"args": ["-y", "@sentinelsup/mcp"],
"env": { "MASKBREAK_API_KEY": "sk_live_your_key" }
}
}
}
Cursor/その他の MCP クライアント
stdio MCP に対応するクライアントであれば、同じ方法で使用できます:コマンドは npx、引数は ["-y", "@sentinelsup/mcp"]、環境変数は MASKBREAK_API_KEY です。
ホステッドエンドポイント(インストール不要)
リモートサーバーを使いますか?同じツールが https://maskbreak.com/mcp(Streamable HTTP)でホストされています。URL ベースの MCP クライアントから接続し、すべての割り当てを利用するには、API キーを Authorization: Bearer ヘッダーで渡します。
使用例
「この IP について、公開フィードでどのような証拠が得られますか?」
以下は不明な IP に対する例示的な応答であり、実際の照会結果ではありません:
{
"ip": "192.0.2.1",
"known": false,
"verdict": "allow",
"risk_score": 0,
"signals": null,
"network": null
}
環境変数
| 変数 | 必須 | デフォルト | 用途 |
|---|---|---|---|
MASKBREAK_API_KEY | 推奨 | — | ダッシュボードから取得する API キーです。プランの照会枠(月 100,000 件、Free プランの場合)を利用できます。v0.1.5 以降に対応しています。以前の SENTINEL_API_KEY という名前も引き続き読み込まれます |
SENTINEL_BASE_URL | いいえ | https://maskbreak.com | テスト用の上書き設定 |
エラーとローカルチェック
どちらのツールも、HTTP エラー、不正な形式の応答、または 5 秒のタイムアウト(本文の読み込みを含む)を超えるリクエストに対して、MCP isError: true を返します。照会できない場合、それは許可の判定ではありません。
npm ci --ignore-scripts
npm test
npm pack --dry-run --ignore-scripts
npm audit
テストでは、実際の stdio MCP クライアントとループバック HTTP フィクスチャを使用し、本番用キーは使用しません。CI では Node.js 18、22、24 をチェックします。これらのチェックによってパッケージが公開されることはありません。
リンク
MIT © Sentinel Edge Networks LTD
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。