Irtoolshed MCP Server

🚀 セキュリティレスポンスツールボックス MCP サーバー

セキュリティ専門家向けに、包括的なモデルコンテキストプロトコル（MCP）サーバーを提供します。このサーバーには、イベントレスポンスやネットワーク分析ツールが含まれています。Claude などの AI エージェントが様々なネットワーククエリと分析を実行し、セキュリティ調査を支援できるようになっています。

🚀 クイックスタート

セキュリティレスポンスツールボックス MCP サーバーは、モデルコンテキストプロトコルを通じてアクセスできる一連のネットワークおよびセキュリティツールを提供します。これは、ネットワークセキュリティイベントレスポンダーが使用する汎用サービスとして設計されており、基本的な検索操作を実行できます。

✨ 主な機能

1. ASN 検索

• 機能: 与えられた IP の自治システム番号 (ASN) と関連する詳細情報を照会します。
• 入力: 有効な IPv4 または IPv6 アドレス。
• 出力: ASN、組織名、登録機関、および地理位置情報を含む JSON レスポンス。

2. DNS レコード検索

• 機能: 指定されたドメイン名の DNS レコード（A、AAAA、MX など）を検索します。
• 入力: 正しいドメイン名。
• 出力: A、AAAA、MX などのすべての関連 DNS レコードタイプの詳細情報を含む。

3. WHOIS レコード検索

• 機能: 指定されたドメイン名の WHOIS 登録情報を取得します。
• 入力: 正しいドメイン名。
• 出力: 登録機関、登録者、作成日、有効期限などの詳細情報を含む JSON レスポンス。

4. IP 地理位置サービス

• 機能: IP アドレスに基づいて地理位置情報を取得します。
• 入力: 有効な IPv4 または IPv6 アドレス。
• 出力: 国、都市、郵便番号、緯度経度、タイムゾーンなどの詳細情報を含む JSON レスポンス。

🔧 技術詳細

エラー処理

各ツールは一貫したエラー処理パターンに従います。

一般的なエラーレスポンス形式:

{
    "状態": "エラー",
    "エラー": "詳細なエラーメッセージ",
    "クエリ": "元のクエリ値"
}

ツール固有のエラー例:

• ASN 検索:

{
    "ip_addr": "<照会した IP>",
    "status": "error",
    "error": "無効な IP アドレス形式"
}

• DNS 検索:

{
    "domain": "<照会したドメイン名>",
    "record_type": "<要求されたタイプ>",
    "status": "error",
    "error": "DNS 解決に失敗しました"
}

• WHOIS 検索:

{
    "domain": "<照会したドメイン名>",
    "status": "error",
    "error": "WHOIS サーバーが利用できません"
}

• 地理位置:

{
    "ip_addr": "<照会した IP>",
    "status": "error",
    "error": "MaxMind データベースが見つからないか、ライセンスキーが無効です"
}

プロジェクト構造

このプロジェクトは標準的な Python パッケージ構造に従っています。

irtoolshed_mcp_server/     # メインパッケージディレクトリ
├── __init__.py           # パッケージ初期化
├── asnlookup.py         # ASN 検索機能
├── dnslookup.py         # DNS 検索機能
├── geolookup.py         # 地理位置機能
├── mcp_server.py        # メイン MCP サーバー実装
└── whoislookup.py       # WHOIS 検索機能

tests/                    # テストディレクトリ
├── test_asnlookup.py    # ASN 検索テスト
├── test_dnslookup.py    # DNS 検索テスト
├── test_geolookup.py    # 地理位置テスト
└── test_whoislookup.py  # WHOIS 検索テスト

📦 インストール

開発環境のセットアップ

1. このリポジトリをクローンします:

git clone <repository-url>
cd ir-toolshed-mcp-server

2. 仮想環境を作成し、依存関係をインストールします:

uv venv
source .venv/bin/activate  # Windows では: .venv\Scripts\activate
uv pip install -e ".[dev]"

テストの実行

テストスイートを実行するには:

uv run pytest

これにより、以下のことが行われます:

• tests/ ディレクトリ内のすべてのテストが実行されます。
• テストカバレッジ情報が表示されます。
• 失敗したテストの詳細出力が表示されます。

注意: 一部のテストには追加の設定が必要です。

• 地理位置テストには MaxMind GeoLite2 データベースとライセンスキーが必要です。
• WHOIS サービスが利用できない場合、WHOIS テストは失敗する可能性があります。

コード品質

このプロジェクトでは、コード品質を維持するためにいくつかのツールを使用しています。

• Black を使用してコードをフォーマットします:

uv run black .

• isort を使用してインポートをソートします:

uv run isort .

• mypy を使用して型チェックを実行します:

uv run mypy .

• ruff を使用して linting を実行します:

uv run ruff .

📚 ドキュメント

将来の計画

完了済み: ✓ ASN 検索 ✓ DNS レコード検索（A、AAAA、MX など）