WHOIS MCP Server

Servidor MCP de WHOIS

Un servidor de consulta WHOIS implementado en Python y basado en el Protocolo de Contexto de Modelo (MCP). Proporciona herramientas MCP para consultar información WHOIS de dominios.

Características

• 🌐 Consulta de información WHOIS de dominios
• 🔧 Basado en el framework FastMCP
• 📡 Compatible con la API de Chinaz
• 🛡️ Validación de entrada y manejo de errores integrados
• 🚀 Soporta múltiples protocolos de transporte (stdio/sse)

Inicio rápido

Instalación

pip install whois-mcp-server

Uso

Modo línea de comandos

# 启动 MCP 服务器
whois-mcp-server

Modo código Python

from whois_mcp.__main__ import whois_query

# 查询域名 WHOIS 信息
result = whois_query("example.com")
print(result)

Documentación de herramientas MCP

whois_query

Consulta la información WHOIS de un dominio específico.

Parámetros

• domain (str): El dominio a consultar, por ejemplo "example.com"

Formato de retorno

{
  "code": 0,
  "message": "success",
  "data": {
    // WHOIS 查询结果
  }
}

Ejemplo de uso

from whois_mcp.__main__ import whois_query

# 查询 qq.com 的 WHOIS 信息
result = whois_query("qq.com")
if result["code"] == 0:
    print("查询成功:", result["data"])
else:
    print("查询失败:", result["message"])

Configuración del entorno

Configuración de la clave API

Configure la variable de entorno de la clave API de Chinaz:

export TAVILY_API_KEY="your_api_key_here"

O en Windows:

set TAVILY_API_KEY=your_api_key_here

Configuración del servidor MCP

Configuración en Claude Desktop

Modifique su archivo claude-desktop-config.json:

{
  "mcpServers": {
    "whoismcp": {
      "command": "whois-mcp-server"
    }
  }
}

Ejecutar con uvx

{
  "mcpServers": {
    "whoismcp": {
      "command": "uvx",
      "args": ["whois-mcp-server"]
    }
  }
}

Desarrollo

Instalación desde el código fuente

git clone https://github.com/your-username/whois-mcp-server.git
cd whois-mcp-server
pip install -e .

Ejecutar pruebas

pytest tests/

Formato de código

black whois_mcp/
flake8 whois_mcp/

Estructura del proyecto

whois-mcp-server/
├── whois_mcp/
│   ├── __init__.py
│   └── __main__.py
├── tests/
│   ├── __init__.py
│   └── test_whois.py
├── pyproject.toml
├── MANIFEST.in
├── LICENSE
└── README.md

Dependencias

• Python 3.8+
• requests>=2.25.0
• mcp>=1.0.0
• fastmcp>=0.1.0

Licencia

Este proyecto está bajo la licencia MIT - consulte el archivo LICENSE para más detalles.

Contribuciones

¡Se aceptan Pull Requests e Issues!

Antes de enviar código, asegúrese de:

1. Que el código cumpla con las normas PEP 8
2. Agregar casos de prueba apropiados
3. Actualizar la documentación relevante

Soporte

Si tiene problemas, envíelos a través de GitHub Issues.