RetroSearch Browse

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://github.com/deshabhishek007/domain-tools-mcp-server below:

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

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

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.

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.

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

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

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

pip install -r requirements.txt

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

python domain_tools_server.py

Or make it executable:

chmod +x domain_tools_server.py
./domain_tools_server.py

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

Enable and start the service:

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

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"]

Build and run:

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

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": {}
    }
  }
}

Parameters:
- domain (string, required): Domain name to lookup

Example Request:

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

Sample Output:

{
  "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
}

Parameters:
- domain (string, required): Domain name to query
- record_types (array, optional): DNS record types to query (default: ["A", "AAAA", "MX", "NS", "TXT", "CNAME", "SOA"])

Example Request:

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

Parameters:
- domain (string, required): Domain name to analyze

Example Request:

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

4. Complete Domain Analysis

Parameters:
- domain (string, required): Domain name to analyze

Example Request:

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

Each tool follows a JSON schema for input. See the code for full details.

All tools return responses in the following format:

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

You can customize the DNS resolver in the server code:

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

You can configure the server using environment variables:

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

Import Errors:
Run pip install --upgrade mcp dnspython python-whois pydantic.
DNS Resolution Failures:
- Check internet connectivity.
- Try different DNS servers.
- Increase timeout values.
WHOIS Lookup Failures:
- Some domains may have restricted WHOIS access.
- Rate limiting may be in effect.
Permission Errors:
- Run with appropriate permissions.
- Use non-privileged ports for testing.

Enable debug logging by adding this to your server:

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

Input Validation: Always validate domain inputs.
Rate Limiting: Implement rate limiting to prevent abuse.
Network Security: Use secure DNS resolvers.
Logging: Log all queries for audit purposes.
Access Control: Implement authentication if needed.

For issues, feature requests, or contributions, please open an issue or pull request on GitHub.
Contributions are welcome! Please review the troubleshooting section and provide detailed error messages and logs if reporting bugs.

This project is licensed under the MIT License. See the LICENSE file for details.

Abhishek Deshpande(@deshabhishek007)

This server is intended for use as a backend service or as part of a larger system that communicates using the MCP protocol.
For more information on MCP, see the official documentation.

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4