Domain Tools MCP Server

🚀 Domain Tools MCP Server

Domain Tools MCP Serverは、WHOIS、DNSレコード、DNSヘルスチェックなど、包括的なドメイン分析を行うためのModel Context Protocol (MCP)サーバーです。

🚀 クイックスタート

Domain Tools MCP Serverを使うことで、ドメインの登録情報やDNS設定を分析・監視することができます。以下のセクションでは、インストール方法、使い方、APIの詳細などを説明します。

✨ 主な機能

• WHOIS情報取得：詳細なドメイン登録データを取得します。
• DNSレコード照会：様々なDNSレコードタイプ（A、AAAA、MX、NS、TXT、CNAME、SOA）を照会できます。
• DNSヘルスチェック：一般的なDNS設定問題を特定します。
• 包括的分析：1つのツールで完全なドメイン評価が可能です。

📦 インストール

1. リポジトリをクローンする

git clone https://github.com/deshabhishek007/domain-tools-mcp-server.git
cd domain-tools-mcp-server

2. 仮想環境を作成する（推奨）

python3 -m venv domain-tools-env
source domain-tools-env/bin/activate

3. 依存関係をインストールする

pip install -r requirements.txt

4. インストールを確認する

python -c "import mcp, dns.resolver, whois; print('All dependencies installed successfully!')"

💻 使用例

MCPクライアントとの統合

サーバーはModel Context Protocolを実装しており、MCP互換のクライアントと統合できます。

MCPクライアント設定の例：

{
  "servers": {
    "domain-tools": {
      "command": "python",
      "args": ["/path/to/domain_tools_server.py"],
      "env": {}
    }
  }
}

📚 ドキュメント

APIリファレンス

利用可能なツール

1. WHOIS照会

• パラメーター：

  • domain (文字列、必須)：照会するドメイン名

• リクエスト例：

{
  "tool": "whois_lookup",
  "arguments": {
    "domain": "example.com"
  }
}

• サンプル出力：

{
  "domain": "example.com",
  "registrar": "Example Registrar Inc.",
  "creation_date": "2023-01-15T00:00:00Z",
  "expiration_date": "2025-01-15T00:00:00Z",
  "updated_date": "2024-01-15T00:00:00Z",
  "status": ["clientTransferProhibited"],
  "name_servers": ["ns1.example.com", "ns2.example.com"],
  "days_until_expiry": 215
}

2. DNSレコード照会

• パラメーター：

  • domain (文字列、必須)：照会するドメイン名
  • record_types (配列、オプション)：照会するDNSレコードタイプ（デフォルト: ["A", "AAAA", "MX", "NS", "TXT", "CNAME", "SOA"]）

• リクエスト例：

{
  "tool": "dns_records",
  "arguments": {
    "domain": "example.com",
    "record_types": ["A", "MX", "NS"]
  }
}

3. DNSヘルスチェック

• パラメーター：

  • domain (文字列、必須)：分析するドメイン名

• リクエスト例：

{
  "tool": "dns_health_check",
  "arguments": {
    "domain": "example.com"
  }
}

4. 完全なドメイン分析

• パラメーター：

  • domain (文字列、必須)：分析するドメイン名

• リクエスト例：

{
  "tool": "domain_analysis",
  "arguments": {
    "domain": "example.com"
  }
}

ツールスキーマ

各ツールはJSONスキーマに従って入力を受け付けます。詳細はコードを参照してください。

レスポンス形式

すべてのツールは以下の形式でレスポンスを返します。

[
  {
    "type": "text",
    "text": "Tool-specific formatted output"
  }
]

設定

DNSリゾルバー

サーバーコード内でDNSリゾルバーをカスタマイズできます。

self.dns_resolver.nameservers = ['8.8.8.8', '8.8.4.4']
self.dns_resolver.timeout = 10
self.dns_resolver.lifetime = 30

環境変数

環境変数を使用してサーバーを設定できます。

export DNS_TIMEOUT=10
export DNS_LIFETIME=30
export WHOIS_TIMEOUT=30
export SERVER_NAME="domain-tools"
export SERVER_VERSION="1.0.0"

🔧 技術詳細

プロジェクト構造

.
├── domain_tools_server.py   # メインサーバー実装
├── requirements.txt
├── .gitignore
├── README.md
└── ...

要件

• Python 3.13+（推奨）
• pip（Pythonパッケージインストーラー）
• DNS/WHOIS照会のためのインターネット接続

デプロイメント

ローカル開発

python domain_tools_server.py

または、実行可能にすることもできます。

chmod +x domain_tools_server.py
./domain_tools_server.py

本番環境デプロイ

systemdを使用する（Linux）

1. サービスファイル /etc/systemd/system/domain-tools-mcp.service を作成します。

[Unit]
Description=Domain Tools MCP Server
After=network.target

[Service]
Type=simple
User=your-username
WorkingDirectory=/path/to/your/project
Environment=PATH=/path/to/your/project/domain-tools-env/bin
ExecStart=/path/to/your/project/domain-tools-env/bin/python domain_tools_server.py
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

2. サービスを有効化して起動します。

sudo systemctl daemon-reload
sudo systemctl enable domain-tools-mcp.service
sudo systemctl start domain-tools-mcp.service

Dockerを使用する

1. Dockerfile を作成します。

FROM python:3.13-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY domain_tools_server.py .
EXPOSE 8080
CMD ["python", "domain_tools_server.py"]

2. ビルドして実行します。

docker build -t domain-tools-mcp .
docker run -p 8080:8080 domain-tools-mcp

トラブルシューティング

一般的な問題

• インポートエラー： pip install --upgrade mcp dnspython python-whois pydantic を実行してください。

• DNS解決失敗：

  • インターネット接続を確認してください。
  • 異なるDNSサーバーを試してみてください。
  • タイムアウト値を増やしてみてください。

• WHOIS照会失敗：

  • 一部のドメインはWHOISアクセスが制限されている場合があります。
  • レート制限が適用されている可能性があります。

• パーミッションエラー：

  • 適切なパーミッションで実行してください。
  • テストには特権のないポートを使用してください。

デバッグモード

サーバーに以下を追加してデバッグログを有効にします。

import logging
logging.basicConfig(level=logging.DEBUG)

セキュリティに関する考慮事項

• 入力検証：常にドメイン入力を検証してください。
• レート制限：乱用を防止するためにレート制限を実装してください。
• ネットワークセキュリティ：安全なDNSリゾルバーを使用してください。
• ロギング：すべてのクエリを監査目的でログに記録してください。
• アクセス制御：必要に応じて認証を実装してください。

サポートと貢献

• 問題、機能要求、または貢献については、GitHubでイシューまたはプルリクエストを開いてください。
• 貢献は大歓迎です！バグを報告する場合は、トラブルシューティングセクションを確認し、詳細なエラーメッセージとログを提供してください。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細は LICENSE ファイルを参照してください。

謝辞

• dnspython
• python-whois
• pydantic
• MCP (Model Context Protocol)

作者

• Abhishek Deshpande(@deshabhishek007)

注意事項

• このサーバーは、MCPプロトコルを使用して通信するバックエンドサービスまたは大規模なシステムの一部として使用することを想定しています。
• MCPの詳細については、公式ドキュメント を参照してください。