Ghidra MCP: conectar un agente de IA a herramientas locales, con aislamiento y trazabilidad de las llamadas

Ghidra MCP: conecta un agente de IA a una herramienta local aislándola (stdio, contenedor sin red) y traza cada llamada con OpenTelemetry.
Ghidra MCP : brancher un agent IA sur des outils locaux, isolation et traçabilité des appels

Ghidra MCP es un buen caso de estudio para conectar un agente de IA a una herramienta local. El proyecto de código abierto GhidraMCP (licencia Apache 2.0) expone las funciones de Ghidra, la herramienta de análisis de binarios de la NSA, a cualquier cliente MCP: listar las funciones de un programa, descompilar, seguir las referencias cruzadas, renombrar símbolos. Los equipos de seguridad defensiva lo usan para acelerar el análisis de sus propios binarios o de muestras en laboratorio.

Para operaciones, la pregunta no es «¿qué sabe hacer el agente?», sino «¿qué puede tocar y cómo saber lo que ha hecho?». Un servidor MCP local corre con los permisos del usuario, lee archivos y algunas de sus herramientas modifican el estado del proyecto. Esta guía muestra cómo aislar este tipo de integración y trazar cada llamada a una herramienta, sin entrar en nada ofensivo.

El contenido no depende de Dynatrace. Si envías las trazas de los agentes a Dynatrace SaaS o Dynatrace Managed, la parte de trazabilidad se apoya en las mismas convenciones de OpenTelemetry que nuestro artículo sobre la observación de agentes MCP.

Cómo funciona Ghidra MCP

GhidraMCP consta de dos partes:

  • un plugin de Ghidra que abre un pequeño servidor HTTP. Su código solo escucha en 127.0.0.1 y solo acepta los nombres de host 127.0.0.1, localhost y [::1];
  • un servidor MCP en Python (ghidra-mcp) que traduce las llamadas a herramientas MCP en peticiones a ese plugin. Por defecto apunta a http://127.0.0.1:8080/.

El servidor MCP acepta tres transportes: stdio (el predeterminado; el cliente lanza el proceso), streamable-http y sse, este último obsoleto. En HTTP escucha por defecto en 127.0.0.1:8081. Un modo headless evita la interfaz gráfica: ghidra-mcp importa y analiza por sí mismo el binario con PyGhidra.

Resumen de las opciones del servidor GhidraMCP extraído de cli.py y backend.py: transportes stdio, streamable-http y sse, backend por defecto 127.0.0.1:8080, escucha MCP 127.0.0.1:8081, plazos de conexión de 5 s y de lectura de 90 s

Si el protocolo MCP es nuevo para ti, empieza por el Model Context Protocol explicado.

Inventariar lo que puede hacer el agente

Antes de conectar nada, lista las herramientas expuestas y clasifícalas por efecto. GhidraMCP declara una treintena con @mcp.tool(). La mayoría leen; ocho modifican el proyecto de Ghidra (renombrado, tipos, comentarios).

Lista de las herramientas declaradas en server.py de GhidraMCP, clasificadas en herramientas de lectura (list_functions, decompile_function, get_xrefs_to, read_memory…) y de escritura (rename_function, set_function_prototype, set_decompiler_comment…)

La especificación de MCP prevé anotaciones de herramienta (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) para señalar estos efectos al cliente. GhidraMCP no las rellena, y la especificación precisa en cualquier caso que son solo indicaciones: un cliente no debe fiarse de ellas cuando el servidor no es de confianza. Tu propia clasificación es la que vale.

En la práctica: aislar un servidor Ghidra MCP

Paso 1: mantenerlo todo en local

Prefiere el transporte stdio: no se abre ningún puerto y el cliente lanza y detiene el proceso. Si tienes que usar streamable-http, deja --mcp-host en 127.0.0.1. No expongas nunca ese puerto en la red: un servidor MCP no tiene autenticación por defecto, como se recuerda en proteger un servidor MCP.

Paso 2: trabajar sobre una copia, en modo headless

El modo headless hace que el análisis sea reproducible y fácil de encerrar. Sin --project, GhidraMCP usa un proyecto temporal y descarta los cambios al salir (--discard es el comportamiento por defecto en ese caso). Monta el binario en solo lectura y corta la red del contenedor:

docker run -i --rm --network none \
  -v "$PWD/echantillons:/work:ro" \
  image-ghidra-mcp-interne \
  ghidra-mcp --headless --binary /work/programme-a-analyser --discard

La imagen tienes que construirla tú (Ghidra, Java y la extensión GhidraMCP): el proyecto no publica ninguna imagen de contenedor. --network none garantiza que una muestra analizada o una herramienta desviada no pueda alcanzar nada. El cliente MCP se comunica por la entrada y la salida estándar gracias a -i.

Paso 3: mantener a una persona en el bucle para la escritura

La especificación de MCP recomienda que una persona pueda siempre rechazar una llamada a una herramienta y que el cliente muestre con claridad qué herramienta se invoca. Aprueba caso por caso las ocho herramientas de escritura; autoriza de forma duradera solo las de lectura, y solo tras el inventario. Algunos clientes ya agrupan las herramientas por efecto, como en el ejemplo siguiente con otro servidor MCP local.

Ajustes de permisos de un cliente MCP extraídos de la documentación de modelcontextprotocol.io: 10 herramientas de solo lectura y 4 herramientas de escritura o borrado del servidor filesystem, cada una con el ajuste Needs approval
Source : github.com

Trazar cada llamada a una herramienta

GhidraMCP escribe sus logs en la salida de error, con nivel INFO: arranque, conexión a Ghidra, importación y análisis del binario. No registra cada llamada a una herramienta. La trazabilidad debe venir, por tanto, del agente o del cliente:

  • Las trazas de OpenTelemetry del agente: las convenciones semánticas de MCP en OpenTelemetry (estado Development) nombran el span {mcp.method.name} {target}, por ejemplo tools/call decompile_function, con los atributos mcp.method.name, mcp.session.id y gen_ai.tool.name. La duración en el cliente se mide con el histograma mcp.client.operation.duration.
  • Los logs de stderr del servidor: redirígelos a un archivo o a tu colector de logs para conservar el rastro de los arranques y de los errores del backend.
  • El MCP Inspector durante la puesta a punto: muestra cada mensaje tools/call, sus parámetros, su respuesta y su duración.

Con estas trazas, una pregunta de auditoría («¿qué agente renombró esta función y cuándo?») se resuelve con una búsqueda de span en lugar de una investigación manual. Para instrumentar tú mismo un servidor, consulta crear un servidor MCP en Python.

Cómo comprobar que funciona

  1. Al arrancar, la salida de error contiene una línea INFO:ghidra_mcp.headless:Analyzing … y después Serving ….
  2. Desde el contenedor, un intento de conexión de red falla: --network none es efectivo.
  3. En tu backend de trazas aparece una llamada tools/call con gen_ai.tool.name rellenado, y una herramienta de escritura solo aparece tras la aprobación.

Buenas prácticas

  • Un servidor MCP por perímetro: un binario, un contenedor, una sesión.
  • Inventaría las herramientas en cada actualización del servidor: una versión nueva puede añadir una herramienta de escritura.
  • Fija plazos: --timeout (90 s por defecto) acota la espera del backend y --ready-timeout (30 s) la del análisis en modo headless.
  • No pases nunca un secreto en los argumentos de la herramienta: acaban en las trazas.
  • Limita el uso a los binarios que tengas derecho a analizar, en un entorno de laboratorio.

Preguntas frecuentes

¿Funciona Ghidra MCP con cualquier cliente MCP?

El README indica que, en teoría, vale cualquier cliente MCP, y da ejemplos para VS Code y Claude Code. Los clientes que se conectan por URL usan el transporte streamable-http.

¿Hace falta la interfaz gráfica de Ghidra?

No. El modo headless (--headless --binary) lanza Ghidra dentro del proceso mediante PyGhidra. Requiere Python 3.10 a 3.13 y la extensión GhidraMCP instalada.

¿Bastan las anotaciones readOnlyHint para bloquear las escrituras?

No. Son indicaciones proporcionadas por el servidor. El control real se hace en el cliente (aprobación, lista de herramientas autorizadas) y mediante el aislamiento del proceso.

Conclusión

Conectar un agente a una herramienta local como Ghidra MCP exige el mismo rigor que un acceso a producción: inventario de herramientas, mínimo privilegio, aislamiento de red, una persona en el bucle para las escrituras y trazas aprovechables. Fuentes: repositorio GhidraMCP y especificación MCP de las herramientas.

span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC ni a los proyectos citados. Las marcas citadas pertenecen a sus propietarios. Las herramientas evolucionan rápido: comprueba siempre los comandos, las opciones y los valores (puertos, versiones, tamaños) en la documentación oficial correspondiente a tu versión.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
Mistral Large 4 en auto-hébergement : ce qui est publié, dimensionnement et supervision

Mistral Large 4 autoalojado: qué está publicado, dimensionamiento y monitorización

Next Post
ONLYOFFICE IA locale avec Ollama ou vLLM : architecture, configuration et supervision

ONLYOFFICE IA local con Ollama o vLLM: arquitectura, configuración y monitorización

Related Posts