Censys

mcp-censys

Censys MCP — Censys Platform API（censys.com）を使用したインターネットスキャン検索

Pipeworx の一部 — AI エージェントを1875以上のライブデータソースに接続するMCPゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとは提携関係になく、承認や公開も受けていません。

ツール

ツール	説明
censys_host	IP でどのようなサービス、ポート、ソフトウェアが稼働しているかを確認します。単一ホストのCensysインターネットスキャンの詳細を返します。詳細には、オープンサービス（ポート／プロトコル／トランスポート）、ソフトウェア、所在地、自律システムが含まれます。例：censys_host({ ip: "8.8.8.8", _apiKey: "your-censys-token" })
censys_host_search	Censysホストから を検索します。Censysクエリ（CenQL）に一致する、インターネットに公開されたホストを検索します。対象はソフトウェア、ポート、製品、ASNなどです。ホストごとにIP、該当するサービス（ポート／サービス／トランスポート）、所在地、自律システムを返します。例：censys_host_search({ q: "services.service_name: HTTP and location.country: Germany", per_page: 25, _apiKey: "your-censys-token" })
censys_cert_search	の証明書を検索します。ドメイン、SAN、またはSHA-256フィンガープリントを使って、Censysの証明書透明性データセットを検索します。証明書ごとにフィンガープリント、名前（SAN）、発行者、有効期間を返します。例：censys_cert_search({ q: "names: example.com", per_page: 25, _apiKey: "your-censys-token" })

クイックスタート

MCPクライアント（Claude Desktop、Cursor、Windsurfなど）に追加します。

{
  "mcpServers": {
    "censys": {
      "url": "https://gateway.pipeworx.io/censys/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/censys/mcp の tools/list は、上記の表にあるツールに加えて、共有のPipeworxメタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール群）を返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック独自のツールとともに、共有ツールが約30個表示されます。initialize の応答には正確な対象範囲が記載されており、その日の状況を確認する際の正式な情報源です。

これは意図的な仕様であり、偶発的な多重化ではありません。メタツールを使うことで、このパックの対象外の質問にも対応できます。ask_pipeworx がカタログ全体からルーティングするため、2つ目のMCPサーバーを追加する必要はありません。現在、これらを含めずにパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングのメリットを上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度接続してください。

また、フルPipeworxゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらのURLも同じゲートウェイと同じ1875以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx を使ってすべてのツールにアクセスできます。

MCPクライアントがない場合：HTTPで呼び出す

このパックでは独自のAPIキー（_apiKey）が必要です。こちらではAPIキーを提供していないため、キーなしで実行できるcurlコマンドはありません。ツールの内容は GET https://gateway.pipeworx.io/v1/tools/censys_host で確認できます。ツールの検索には POST https://gateway.pipeworx.io/v1/tools/search_packs を使い、{"query":"..."} を渡します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルのstdio MCPサーバーとしても動作します。Pipeworxアカウントやゲートウェイへの往復通信は必要ありません。

{
  "mcpServers": {
    "censys": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-censys"]
    }
  }
}

または、直接実行して起動を確認します。

npx -y @pipeworx/mcp-censys

stdin/stdout経由でMCPを使用し、initialize／tools/list／tools/call に対して、このパックのツールのみを返します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールを使い、ask_pipeworxによるルーティングはありません。

ask_pipeworxを使う

ツールを直接呼び出す代わりに、自然な英語で質問できます。この方法は、上記のパックエンドポイントでもフルゲートウェイでも使えます。

ask_pipeworx({ question: "your question about Censys data" })

ゲートウェイが適切なツールを選択し、引数を自動で設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT