Servidor MCP de Inteligencia de Amenazas

Un servidor FastMCP que proporciona herramientas de inteligencia de amenazas e investigación de vulnerabilidades para Claude. Se integra con NVD, VirusTotal, AbuseIPDB, Shodan y MITRE ATT&CK.

Herramientas

Related MCP server: Exploit Intel Platform MCP Server

Configuración

1. Crear y activar un entorno virtual:

python -m venv venv
.\venv\Scripts\Activate.ps1

2. Instalar dependencias:

pip install -r requirements.txt

3. Configurar claves de API — copia .env.example a .env y rellena tus claves:

VIRUSTOTAL_API_KEY=your_key_here
ABUSEIPDB_API_KEY=your_key_here
SHODAN_API_KEY=your_key_here

Claves de API gratuitas: VirusTotal · AbuseIPDB · Shodan

Claude Desktop

Dado que el servidor ahora se ejecuta a través de HTTP, inícialo primero y luego configura Claude Desktop para conectarse a través de la URL.

1. Iniciar el servidor (mantén esto en ejecución):

python server.py

2. Añadir a %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "threat-intel": {
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

Las claves de API se leen automáticamente desde .env.

Importante: Claude Desktop solo lee claude_desktop_config.json al iniciarse. Después de guardar la configuración, cierra completamente y reinicia Claude Desktop; los cambios no surten efecto mientras se está ejecutando.

Inspector MCP

El servidor se ejecuta a través de HTTP (Streamable HTTP) en el puerto 8000. Inícialo primero y luego conecta el inspector.

1. Iniciar el servidor:

python server.py

2. Iniciar el inspector:

npx @modelcontextprotocol/inspector

Abre http://localhost:5173, establece el transporte en Streamable HTTP e introduce la URL http://127.0.0.1:8000/mcp.

Añadir nuevas herramientas

1. Crea tools/newtool.py con tu función asíncrona

2. Regístrala en server.py:

from tools.newtool import my_function as _my_function

@mcp.tool()
async def my_tool(param: str) -> str:
    """Tool description shown in Inspector and to the LLM.

    Args:
        param: Parameter description
    """
    return str(await _my_function(param))

FastMCP genera el esquema JSON automáticamente a partir de la firma y el docstring.

Límites de tasa de API

Solución de problemas

Errores JSON-RPC / EOF — Este servidor utiliza transporte HTTP. Ejecuta python server.py directamente para iniciarlo; mcp dev no es necesario y solo se requiere para servidores basados en stdio.

Clave de API no encontrada — Asegúrate de que .env exista en la raíz del proyecto (copia desde .env.example). Al iniciarse, el servidor imprime una advertencia enumerando las claves no configuradas y a qué herramientas afectan.

Errores de límite de tasa — Espera antes de volver a intentarlo o actualiza a un nivel de API de pago.