MCP Censys

🚀 mcp-censys

mcp-censys は、Censys 検索 API に接続するための MCP サーバーです。これを使用すると、ドメイン名、IP アドレス、FQDN の情報をリアルタイムで取得でき、強化された MCP ヒントテンプレートを提供します。

⚠️ 重要提示

このツールはデモ用途のみで使用されることを意図しており、本番環境での使用は避けてください。

🚀 クイックスタート

mcp-censys を使用するには、まずインストールする必要があります。以下の手順に従って操作してください。

📦 インストール

# リポジトリをクローンする
git clone https://github.com/yourusername/mcp-censys.git
cd mcp-censys

# Docker イメージをビルドする
docker build -t mcp/censys .

# .env ファイルには以下の内容が含まれる必要があります。
CENSYS_API_ID=your_censys_api_id
CENSYS_API_SECRET=your_censys_api_secret

📚 ドキュメント

MCP 設定

Claude Desktop の設定に以下の内容を追加してください。

"censys": {
  "command": "docker",
  "args": [
    "run",
    "--rm",
    "-i",
    "--env-file", "/Users/yourname/.env.censys",
    "mcp/censys"
  ]
}

スクリーンショット

以下は、Claude Desktop での mcp-censys の実際の操作例です。

• ドメイン/FQDN クエリ：
  ドメインの IP、ASN、サブドメイン、サービスなどの情報を表示します。
• 詳細ドメインクエリ：
  IP、ASN、BGP、TLS などのより詳細なドメイン情報を返します。
• IP クエリ：
  IP の座標、正引きと逆引きの DNS、サービス情報を表示します。

トラブルシューティング

結果が返されない場合

• 対象が公開されていることを確認してください。
• API キーとレート制限を確認してください。
• DNS 結果は Censys の最新の観測データに依存します。

パフォーマンスのヒント

• 一度に 1 つのドメインまたは IP をクエリすることで、速度を向上させることができます。
• lookup_domain または lookup_ip を使用して、より焦点を絞ったデータを取得してください。

API 応答の問題

• 結果の形式が誤っている場合は、最新バージョンを使用していることを確認してください。
• ツールは自動的にページングを処理します。lookup_domain は利用可能なすべての結果を収集し、lookup_domain_detailed は一部のレコードのみを表示します。

制限事項

• new_fqdns は、実際の「初出」の FQDN を表すものではなく、最後の観測時間に基づいてフィルタリングされます。
• このツールは単一の対象の分析に適しており、バッチスキャンには適していません。
• lookup_domain_detailed は、応答サイズを抑えるために 3 件のレコードのみを表示します。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。

謝辞

以下のプロジェクトの貢献に感謝します。

• Censys Python SDK (https://github.com/censys/censys-python)
• Model Context Protocol (https://modelcontextprotocol.io/)
• Claude Desktop (https://www.anthropic.com)