Skip to main content
Glama
enesjakozh

IR Toolshed MCP Server

by rossja
GitHub
Python
Apache 2.0
1
  • Linux
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Servidor MCP de IR Toolshed

Un servidor integral de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas de respuesta a incidentes y análisis de red para profesionales de la seguridad. Este servidor permite a agentes de IA como Claude realizar diversas búsquedas y análisis relacionados con la red para facilitar las investigaciones de seguridad.

Descripción general

El servidor MCP de IR Toolshed ofrece un conjunto de herramientas de red y seguridad accesibles mediante el Protocolo de Contexto de Modelo. Está diseñado como un servicio de propósito general para los responsables de la respuesta a incidentes de red, permitiéndoles realizar búsquedas básicas mediante:

  • Búsquedas de ASN (Número de sistema autónomo)

  • Búsquedas y análisis de DNS

  • Recuperación de registros WHOIS

  • Geolocalización de IP

  • Y más capacidades de análisis de red por venir

Cada herramienta viene acompañada de documentación detallada como recurso, lo que facilita que los sistemas de IA comprendan cómo usar las herramientas y qué resultados esperar.

Herramientas actuales

Herramienta de búsqueda de ASN

La herramienta de búsqueda ASN devuelve información sobre una dirección IP, incluyendo:

  • La dirección IP que se consultó

  • El número AS asociado con la dirección IP

  • El nombre de la organización propietaria del número AS

Herramienta de búsqueda de DNS

La herramienta de búsqueda de DNS proporciona información de registros DNS para dominios:

  • Admite múltiples tipos de registros (A, AAAA, MX, NS, TXT)

  • Devuelve registros DNS formateados

  • Maneja consultas tanto IPv4 como IPv6

Herramienta de búsqueda WHOIS

La herramienta de búsqueda WHOIS recupera información de registro de dominio:

  • Detalles de propiedad del dominio

  • Fechas de inscripción

  • Información del servidor de nombres

  • Datos del registrador

Herramienta de geolocalización

La herramienta de geolocalización IP proporciona información de ubicación utilizando la base de datos GeoLite2 de MaxMind:

  • Datos de ubicación a nivel de país y ciudad

  • Coordenadas de latitud y longitud

  • Información de la red

  • Datos de zona horaria

Nota: La herramienta de geolocalización requiere una clave de licencia de MaxMind. Puede:

  1. Obtenga una clave gratuita en: https://dev.maxmind.com/geoip/geolite2-free-geolocation-data

  2. Cualquiera:

    • Establezca la variable de entorno MAXMIND_LICENSE_KEY

    • Proporciónelo como parámetro al utilizar la herramienta

    • Introdúzcalo cuando se le solicite

Se agregarán más herramientas en futuras versiones.

Prerrequisitos

  • Python 3.8 o más reciente (se recomienda 3.13+)

  • gestor de paquetes uv Python

Instalación

  1. Clonar este repositorio:

git clone <repository-url> cd ir-toolshed-mcp-server

  1. Crear un entorno virtual:

uv venv

  1. Activar el entorno virtual:

En Windows:

.venv\Scripts\activate

En macOS/Linux:

source .venv/bin/activate

  1. Instalar el paquete en modo de desarrollo:

uv pip install -e .

Ejecución del servidor

Inicie el servidor MCP con:

uv run mcp dev src/mcp_server.py

Esto lanzará el servidor en modo de desarrollo, haciéndolo disponible para clientes MCP como Claude Desktop.

Usando las herramientas

Herramienta de búsqueda de ASN

Cuando se conecta a un cliente MCP como Claude Desktop, puede utilizar la herramienta de búsqueda ASN proporcionando una dirección IP:

asnlookup("8.8.8.8")

Ejemplo de salida:

{ "ip_addr": "8.8.8.8", "as_number": "15169", "as_name": "GOOGLE - Google LLC" }

Herramienta de búsqueda de DNS

Cuando se conecta a un cliente MCP como Claude Desktop, puede utilizar la herramienta de búsqueda DNS proporcionando un dominio:

dnslookup("example.com")

Ejemplo de salida:

{ "domain": "example.com", "record_type": "A", "record_value": "93.184.216.34" }

Herramienta de búsqueda WHOIS

Cuando se conecta a un cliente MCP como Claude Desktop, puede utilizar la herramienta de búsqueda WHOIS proporcionando un dominio:

whoislookup("example.com")

Ejemplo de salida:

{ "domain": "example.com", "ownership_details": "Google LLC", "registration_date": "2004-04-26", "nameserver_information": "ns1.google.com", "registrar_details": "MarkMonitor Inc." }

Herramienta de geolocalización

Cuando se conecta a un cliente MCP como Claude Desktop, puede utilizar la herramienta de geolocalización proporcionando una dirección IP:

geolocation("8.8.8.8")

Ejemplo de salida:

{ "ip_addr": "8.8.8.8", "country": "US", "city": "Mountain View", "latitude": 37.40599, "longitude": -122.078514, "network": "AS15169 Google LLC", "timezone": "America/Los_Angeles" }

Manejo de errores

Cada herramienta sigue un patrón de manejo de errores consistente:

Formato de respuesta de error general:

{ "status": "error", "error": "Detailed error message", "query": "Original query value" }

Ejemplos de errores específicos de la herramienta:

Búsqueda de ASN:

{ "ip_addr": "<queried-ip>", "status": "error", "error": "Invalid IP address format" }

Búsqueda de DNS:

{ "domain": "<queried-domain>", "record_type": "<requested-type>", "status": "error", "error": "DNS resolution failed" }

Búsqueda WHOIS:

{ "domain": "<queried-domain>", "status": "error", "error": "WHOIS server not available" }

Geolocalización:

{ "ip_addr": "<queried-ip>", "status": "error", "error": "MaxMind database not found or license key invalid" }

Estructura del proyecto

El proyecto sigue una estructura de paquete Python estándar:

irtoolshed_mcp_server/ # Main package directory ├── __init__.py # Package initialization ├── asnlookup.py # ASN lookup functionality ├── dnslookup.py # DNS lookup functionality ├── geolookup.py # Geolocation functionality ├── mcp_server.py # Main MCP server implementation └── whoislookup.py # WHOIS lookup functionality tests/ # Test directory ├── test_asnlookup.py # ASN lookup tests ├── test_dnslookup.py # DNS lookup tests ├── test_geolookup.py # Geolocation tests └── test_whoislookup.py # WHOIS lookup tests

Desarrollo

Configuración del entorno de desarrollo

  1. Clonar este repositorio:

git clone <repository-url> cd ir-toolshed-mcp-server

  1. Cree un entorno virtual e instale dependencias:

uv venv source .venv/bin/activate # On Windows use: .venv\Scripts\activate uv pip install -e ".[dev]"

Ejecución de pruebas

Para ejecutar el conjunto de pruebas:

uv run pytest

Esto hará lo siguiente:

  • Ejecutar todas las pruebas en el directorio tests/

  • Mostrar información de cobertura de la prueba

  • Mostrar salida detallada para cualquier falla

Nota: Algunas pruebas requieren configuración adicional:

  • Las pruebas de geolocalización requieren una base de datos MaxMind GeoLite2 y una clave de licencia

  • Las pruebas WHOIS pueden fallar si el servicio WHOIS no está disponible

Calidad del código

El proyecto utiliza varias herramientas para mantener la calidad del código:

  • Código de formato con negro:

uv run black .

  • Ordenar importaciones con isort:

uv run isort .

  • Ejecutar la comprobación de tipos con mypy:

uv run mypy .

  • Ejecutar pelusa con ruff:

uv run ruff .

Hoja de ruta

Completado: ✓ Búsquedas de ASN ✓ Búsquedas de registros DNS (A, AAAA, MX, etc.) ✓ Recuperación de registros WHOIS ✓ Servicios de geolocalización de IP

Herramientas futuras planificadas para su inclusión:

  • Puntuación de reputación de dominio

  • Análisis de certificados SSL

  • Escaneo de puertos de red

  • Integración de inteligencia de amenazas

  • Historial de DNS pasivo

  • Análisis de seguridad del correo electrónico (SPF, DKIM, DMARC)

  • Análisis de ruta BGP

  • Visualización del tráfico de red

  • Búsquedas de hash de malware

  • Comprobación de la reputación de URL

Contribuyendo

Se agradecen las contribuciones para añadir nuevas herramientas de IR o mejorar las existentes. Siga estos pasos:

  1. Bifurcar el repositorio

  2. Crear una rama de características

  3. Agregue su herramienta siguiendo el patrón existente en mcp_server.py

  4. Incluir documentación apropiada como recurso

  5. Envíe una solicitud de extracción con una descripción clara de sus cambios

Licencia

Apache 2.0

Consideraciones de seguridad

Este servidor está diseñado para la investigación legítima de seguridad y la respuesta a incidentes. Los usuarios deben asegurarse de cumplir con todas las leyes y normativas aplicables al utilizar estas herramientas.

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Un servidor de protocolo de contexto de modelo que proporciona herramientas de análisis de red para profesionales de seguridad, permitiendo que modelos de IA como Claude realicen tareas como búsquedas de ASN, análisis de DNS, recuperación de WHOIS y geolocalización de IP para investigaciones de seguridad.

  1. Descripción general
    1. Herramientas actuales
      1. Herramienta de búsqueda de ASN
      2. Herramienta de búsqueda de DNS
      3. Herramienta de búsqueda WHOIS
      4. Herramienta de geolocalización
    2. Prerrequisitos
      1. Instalación
        1. En Windows:
        2. En macOS/Linux:
      2. Ejecución del servidor
        1. Usando las herramientas
          1. Herramienta de búsqueda de ASN
          2. Herramienta de búsqueda de DNS
          3. Herramienta de búsqueda WHOIS
          4. Herramienta de geolocalización
        2. Manejo de errores
          1. Estructura del proyecto
            1. Desarrollo
              1. Configuración del entorno de desarrollo
              2. Ejecución de pruebas
              3. Calidad del código
            2. Hoja de ruta
              1. Contribuyendo
                1. Licencia
                  1. Consideraciones de seguridad

                    Related MCP Servers

                    • AWS Security MCP

                      groovyBugify
                      A
                      security
                      A
                      license
                      A
                      quality
                      A Model Context Protocol server that connects AI assistants like Claude to AWS security services, allowing them to autonomously query, inspect, and analyze AWS infrastructure for security issues and misconfigurations.
                      Last updated -
                      75
                      Apache 2.0
                      • Apple

                    • Wireshark MCP

                      sarthaksiddha
                      -
                      security
                      F
                      license
                      -
                      quality
                      A Model Context Protocol server that integrates Wireshark's network analysis capabilities with AI systems like Claude, allowing direct analysis of network packet data without manual copying.
                      Last updated -
                      8
                      • Apple
                      • Linux

                    • SharkMCP

                      kriztalz
                      A
                      security
                      A
                      license
                      A
                      quality
                      A Model Context Protocol server that provides network packet capture and analysis capabilities through Wireshark/tshark integration, enabling AI assistants to perform network security analysis and troubleshooting.
                      Last updated -
                      4
                      23
                      MIT License
                      • Apple
                      • Linux

                    • Domain Tools MCP Server

                      deshabhishek007
                      -
                      security
                      A
                      license
                      -
                      quality
                      A Model Context Protocol server that provides comprehensive domain analysis capabilities including WHOIS lookups, DNS record queries, and DNS health checking.
                      Last updated -
                      7
                      MIT License
                      • Linux

                    View all related MCP servers

                    Appeared in Searches

                    New MCP Servers

                    MCP directory API

                    We provide all the information about MCP servers via our MCP API.

                    curl -X GET 'https://glama.ai/api/mcp/v1/servers/rossja/irtoolshed-mcp-server'

                    If you have feedback or need assistance with the MCP directory API, please join our Discord server