Domain Tools MCP Server

A Model Context Protocol (MCP) server for comprehensive domain analysis: WHOIS, DNS records, and DNS health checks.

Table of Contents

1. Overview
2. Features
3. Project Structure
4. Requirements
5. Installation
6. Deployment
7. Usage
8. API Reference
9. Configuration
10. Troubleshooting
11. Security Considerations
12. Support and Contribution
13. License
14. Acknowledgments

Overview

The Domain Tools MCP Server is a Model Context Protocol (MCP) server that provides comprehensive domain analysis capabilities. It offers tools for WHOIS lookups, DNS record queries, and DNS health checking to help you analyze and monitor domain configurations.

Features

• WHOIS Information: Get detailed domain registration data.
• DNS Records: Query various DNS record types (A, AAAA, MX, NS, TXT, CNAME, SOA).
• DNS Health Checks: Identify common DNS configuration issues.
• Comprehensive Analysis: Complete domain assessment in one tool.

Project Structure

.
├── domain_tools_server.py   # Main server implementation
├── requirements.txt
├── .gitignore
├── README.md
└── ...

Requirements

• Python 3.13+ (recommended)
• pip (Python package installer)
• Internet connection for DNS/WHOIS queries

Installation

1. Clone the Repository

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

2. Create a Virtual Environment (Recommended)

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

3. Install Dependencies

pip install -r requirements.txt

4. Verify Installation

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

Deployment

Local Development

python domain_tools_server.py

Or make it executable:

chmod +x domain_tools_server.py
./domain_tools_server.py

Production Deployment

Using systemd (Linux)

1. Create a service file /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. Enable and start the service:

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

Using Docker

1. Create a 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. Build and run:

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

Usage

MCP Client Integration

The server implements the Model Context Protocol and can be integrated with any MCP-compatible client.

Example MCP Client Configuration:

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

API Reference

Available Tools

1. WHOIS Lookup

• Parameters:

  • domain (string, required): Domain name to lookup

• **Examp

... View full README on GitHub