WHOIS MCP Server

WHOIS MCP Server

Um servidor de consulta WHOIS implementado em Python e Model Context Protocol (MCP). Fornece ferramentas MCP para consultar informações WHOIS de domínios.

Recursos

• 🌐 Consulta de informações WHOIS de domínios
• 🔧 Baseado no framework FastMCP
• 📡 Suporte à API Chinaz
• 🛡️ Validação de entrada e tratamento de erros integrados
• 🚀 Suporte a múltiplos protocolos de transporte (stdio/sse)

Início Rápido

Instalação

pip install whois-mcp-server

Uso

Linha de comando

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

Código Python

from whois_mcp.__main__ import whois_query

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

Documentação das Ferramentas MCP

whois_query

Consulta as informações WHOIS de um domínio especificado.

Parâmetros

• domain (str): O domínio a ser consultado, por exemplo, "example.com"

Formato de Retorno

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

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

Configuração de Ambiente

Configuração da API Key

Defina a variável de ambiente da API Key Chinaz:

export TAVILY_API_KEY="your_api_key_here"

Ou no Windows:

set TAVILY_API_KEY=your_api_key_here

Configuração do Servidor MCP

Configuração no Claude Desktop

Modifique seu arquivo claude-desktop-config.json:

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

Executando com uvx

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

Desenvolvimento

Instalação a partir do código-fonte

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

Executando testes

pytest tests/

Formatação de código

black whois_mcp/
flake8 whois_mcp/

Estrutura do Projeto

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

Dependências

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

Licença

Este projeto é licenciado sob a licença MIT - consulte o arquivo LICENSE para obter detalhes.

Contribuição

Pull Requests e Issues são bem-vindos!

Antes de enviar código, certifique-se de:

1. O código está em conformidade com PEP 8
2. Adicione casos de teste apropriados
3. Atualize a documentação relevante

Suporte

Em caso de problemas, envie-os via GitHub Issues.