Website Reputation Checker

@gridinsoft/mcp-inspector

GridinSoft Inspectorを利用した、ドメインのレピュテーションおよびURL分析用のModel Context Protocolサーバーです。

要件

• Node.js 22以降。MCP ホストで npm/npx を利用できる必要があります。
• プロフィールから取得した GridinSoft Inspector API キー。

npm パッケージは stdio 経由でローカルに実行され、HTTPS 経由で Inspector REST API を呼び出します。https://inspector.gridinsoft.com/mcp はドキュメントページです。/mcp/v1 は、このパッケージが使用する REST ブリッジです。どちらの URL も、ネイティブのリモート MCP Streamable HTTP エンドポイントまたは SSE エンドポイントではありません。

MCP クライアントを接続する

クライアントの MCP サーバー設定に、次のエントリを追加します。

{
  "mcpServers": {
    "gridinsoft": {
      "command": "npx",
      "args": ["-y", "@gridinsoft/mcp-inspector"],
      "env": {
        "GRIDINSOFT_API_KEY": "your_api_key_here"
      }
    }
  }
}

MCP ホストでサポートされている設定場所とコマンドのトランスポートを使用してください。npx が見つからない場合は、Node.js インストール先にある npx 実行ファイルの絶対パスを指定してください。

URL スキャンには最大90秒かかることがあります。クライアントが対応している場合は、MCP リクエストのタイムアウトを120秒以上に設定してください。アダプターの HTTP タイムアウトはデフォルトで110秒で、GRIDINSOFT_TIMEOUT_MS（ミリ秒単位の正の整数）で設定できます。送信したスキャンですでにクレジットが消費されている可能性があるため、アダプターはリクエストを自動的に再試行しません。タイムアウトした場合は、再度送信する前に Inspector ダッシュボードを確認してください。

ツール

ツール	入力	目的	クレジット
inspect_domain	{"domain":"example.com"}	利用可能なレピュテーションスコア、判定、カテゴリ、レポートへのリンク	3
check_domain_safety	{"domain":"example.com"}	inspect_domain のエイリアス	3
get_domain_reputation	{"domain":"example.com"}	inspect_domain のエイリアス	3
scan_url	{"url":"https://example.com/login"}	ページのメタデータと利用可能なセキュリティシグナル。追加の分析内容はプランによって異なります	10
get_balance	{}	残りのクレジットとサブスクリプションの状態	無料

Unknown 判定は、評価が利用できないことを意味します。対象が安全であることを意味するわけではありません。ツールの実行エラーは、isError: true と content 内の説明を返します。ディスカバリーまたはプロンプト／リソースのエラーは、MCP エラーとして通知されます。

プロンプトとリソース

• check-website-safety には site 引数（URL またはドメイン）が必要です。
• verify-domain-trust には domain 引数が必要です。
• gs://guide/threat-categories では、セキュリティおよびコンテンツのカテゴリについて説明しています。コンテンツカテゴリだけでは、マルウェアや詐欺があるとは判断できません。

プロンプト引数の例：

{
  "name": "check-website-safety",
  "arguments": { "site": "https://example.com" }
}

コマンドラインでの使用

環境変数に GRIDINSOFT_API_KEY を設定した状態で、次を実行します。

npx -y @gridinsoft/mcp-inspector check example.com
npx -y @gridinsoft/mcp-inspector inspect example.com
npx -y @gridinsoft/mcp-inspector scan https://example.com/login
npx -y @gridinsoft/mcp-inspector --help

コマンドはツールの結果を JSON 形式で出力し、失敗時にはゼロ以外のステータスで終了します。引数なしで実行すると、クライアントから起動された場合に stdio MCP サーバーが起動します。

プラン

新規アカウントには、毎月100クレジット分の無料 API クレジットが付与されます。現在のプランと料金については、Inspector ダッシュボードをご覧ください。

開発

npm ci
npm test
npm run build
npm pack --dry-run

テストでは、MCP の初期化、ディスカバリー、プロンプト引数の転送、リソース、ツールのエイリアス、認証エラー、HTTP エラー、キャンセル、タイムアウト、stdio のフレーミング、CLI の終了コードを確認します。Composer の依存関係をインストールした Inspector のチェックアウトに対して、追加のバックエンド統合フィクスチャを実行できます。

INSPECTOR_TEST_ROOT=/absolute/path/to/inspector node --test test/php-integration.cjs

このフィクスチャは一時的な localhost PHP サーバーを起動し、実際の MCP ルート／コントローラーを使用して、公開リクエストまたは認証不要のリクエストのみを実行します。アプリケーションの環境ファイルは読み込まず、有料スキャンも実行しません。

ライセンス

MIT