Inicio / Artículos

Siete preguntas que hacer antes de ejecutar un servidor MCP local

Una lista de verificación para aislar en entorno seguro a los servidores MCP locales, probada en el servidor de GitHub: tokens de corta duración, red sellada, lista de permisos de salida y listas de herramientas fijas.

Editor: REACTAPP.TOP8 min de lectura1726 palabras

Fuentes: the seven questions i ask before running a local mcp server — part 2

Instalar un servidor MCP local generalmente implica pegar un fragmento de código en un archivo de configuración:

{
  "mcpServers": {
    "some-tool": { "command": "npx", "args": ["-y", "some-mcp-server"] }
  }
}

Eso son tres líneas, sin revisión, sin diálogo de permisos y sin paso de instalación en el que realmente alguien piense. Vale la pena detenerse a pensar en qué hacen esas líneas. Un servidor MCP local no es un servicio: no tiene puerto, no requiere inicio de sesión y no tiene límites. Es un programa que el agente inicia, ejecutándose como el usuario actual, con acceso a los archivos y al entorno de ese usuario. Las solicitudes de permiso que muestra un agente reflejan lo que hace el agente, mientras que el programa detrás de una llamada a la herramienta ya tiene pleno control de la máquina.

Un hábito mejor es hacer siete preguntas antes de instalar y dejar que las respuestas determinen la configuración.

Las siete preguntas

  1. ¿Funciona localmente? Los servidores MCP remotos se encuentran en la máquina de un tercero y no pueden ser confinados, lo que hace que el resto de la lista carezca de relevancia. A veces esto es una decisión en lugar de algo establecido, y elegir cuidadosamente entre opción remota y local puede hacer que las otras seis preguntas dejen de ser relevantes.
  2. ¿Necesita credenciales? O ninguna, o una específica que pueda ser identificada.
  3. ¿A dónde se conecta? Ya sea a una lista corta y fija de hosts o a cualquier URL.
  4. ¿Qué archivos necesita? Un espacio de trabajo, todo, o nada.
  5. ¿Necesita algo más del host? Una sesión de escritorio, un socket, un navegador.
  6. ¿Ejecuta código que descarga? Si es así, ese código necesita ser fijado.
  • ¿Cuántas herramientas ofrece y se pueden desactivar algunas? Cada herramienta aumenta la superficie de ataque, y algunos servidores permiten reducir esa lista.
  • Las preguntas del uno al seis se pueden responder con la documentación propia del servidor en aproximadamente diez minutos, sin necesidad de buscar en fuentes externas. Solo la séptima cuenta con una medida concreta: una única llamada a tools/list después de la instalación, y el número de herramientas suele superar las expectativas.

    Ejemplo práctico: el servidor de GitHub

    Pregunta Respuesta para el servidor de GitHub
    ¿Funciona localmente? Sí, y ya viene incluido como imagen de contenedor
    Credenciales Son necesarias, ya que los repositorios privados no se pueden leer de forma anónima
    ¿A dónde se conecta? A un único host, api.github.com
    Archivos Ninguno adicional al clave. El trabajo se realiza a través de la API, por lo que no existe ningún clon ni descarga en el disco
    Otros requisitos del host Ninguno
    Obtención de código en tiempo de ejecución No
    Lista de herramientas Puede reducirse mediante --toolsets y --exclude-tools

    En conjunto, las respuestas definen la configuración: una credencial, ninguna carpeta montada, un único destino y una lista de herramientas que debe reducirse.

    La credencial es la parte más complicada, ya que no se puede eliminar del diseño. Si un agente abre solicitudes de pull, debe tener acceso de escritura. En su lugar, se aplican medidas de control, comenzando por usar una GitHub App en lugar de un token de acceso personal:

    {
      "mcpServers": {
        "github": {
          "command": "docker",
          "args": [
            "run",
            "--rm",
            "-i",
            "--network",
            "mcp-egress-github",
            "--read-only",
            "--tmpfs",
            "/tmp",
            "--cap-drop",
            "ALL",
            "--security-opt",
            "no-new-privileges",
            "--user",
            "10001:10001",
            "--log-driver",
            "journald",
            "-e",
            "HTTPS_PROXY=http://mcp-egress-proxy:3128",
            "-e",
            "HTTP_PROXY=http://mcp-egress-proxy:3128",
            "-v",
            "/home/<user>/.config/mcp-gh/<app>.private-key.pem:/key.pem:ro",
            "ghcr.io/github/github-mcp-server@sha256:508a0857ec762b1ab1cece29193345b501fab1dd9d1228a7b617062954cecac6",
            "stdio",
            "--app-id",
            "NNNNNNN",
            "--app-installation-id",
            "NNNNNNNNN",
            "--app-private-key-path",
            "/key.pem",
            "--toolsets",
            "context,issues,pull_requests,repos",
            "--exclude-tools",
            "create_repository,fork_repository,get_teams,get_team_members,list_repository_collaborators"
          ]
        }
      }
    }
    

    Las capas que rodean esa credencial

    • Tokens de corta duración. Una aplicación de GitHub genera tokens que caducan rápidamente.
    • Montajes de solo lectura. La clave de firma se monta en modo de solo lectura y pertenece al UID al que se mapea el contenedor, no al usuario. No se encuentra en ~/.ssh, donde ya no sería una clave SSH ni podría ser leída por el usuario.
    • Contenedores sin privilegios. El demonio de Docker funciona en modo sin root; el proceso utiliza un usuario que no es root y no se le otorgan capacidades especiales.
    • Un repositorio, cuatro permisos. contents, issues y pull_requests tienen permisos de escritura, metadata tiene permisos de lectura, y cada token generado incluye exactamente esos permisos.
    • Una red sellada. No existe ruta directa hacia el exterior, por lo que el proxy es el único camino posible.
    • Lista de permisos de salida. Todo lo que se genera dentro del contenedor solo puede enviarse a api.github.com.
    • Conjuntos de herramientas fijados y herramientas excluidas. --toolsets retiene grupos completos, mientras que --exclude-tools elimina todo lo que queda dentro de los grupos conservados.

    Los dos últimos puntos reciben poca atención. Reducir la lista de herramientas representa el menor nivel de privilegios que aún permite el acceso de escritura. La lista de permisos protege más que solo los archivos locales, ya que limita dónde pueden utilizarse las credenciales robadas.

    Esa afirmación merece una medición. Con --toolsets context,issues,pull_requests,repos, el servidor expone 42 herramientas. Cinco de ellas no pueden utilizarse con estos permisos. Después de aplicar --exclude-tools, quedan 37, y 15 de ellas pueden realizar operaciones de escritura. Dado que --toolsets selecciona grupos completos, repos incluye también create_repository y fork_repository, independientemente de si el token puede usarlas o no. 37 no es un número pequeño, pero sí preciso, y representa el nivel mínimo de privilegios necesario cuando un agente realmente debe subir un branch.

    Por qué la lista de permisos permitidos no es excesiva

    Al principio, la lista de permisos parece excesiva, hasta que uno se pregunta qué es lo que impide. Nadie puede hacer que el contenedor se comunique con attacker.com, por lo que un token creado allí no tiene a dónde dirigirse en entornos hostiles. El registro del proxy registra ambos resultados para cada intento:

    10.123.2.3 TCP_TUNNEL/200  CONNECT api.github.com:443  HIER_DIRECT/140.82.121.6
    10.123.2.3 TCP_DENIED/403  CONNECT example.com:443     HIER_NONE/-
    

    La bandera -e HTTPS_PROXY no es la que impone eso. Linux no cuenta con un concepto integrado de proxy, ni un interruptor en el kernel ni un gancho en libc. La variable es simplemente texto en el entorno, y cada cliente HTTP decide si la respeta o no. net/http de Go sí la respeta, por lo que este servidor en particular no necesita ningún trabajo adicional. fetch integrado en Node no lo hace, lo que significa que un servidor Node ignoraría por completo ese ajuste. La medida de protección radica en la estructura de la red: al no haber ruta de salida, un cliente que ignore la variable no se conectará directamente, sino que simplemente generará un error. En una red con ruta, esa misma omisión permitiría que el tráfico se filtrara sin ninguna advertencia.

    Verificación contra la lista OWASP MCP Top 10

    La correspondencia de esta configuración con la lista OWASP MCP Top 10 clasifica cada riesgo como abordado, residual y gestionado, no abordado, o no aplicable a un servidor stdio local, con notas sobre qué aspectos permanecen sin resolver.

    Qué sigue estando fuera del alcance

    Ninguna sandbox es nunca completa. Hay tres temas que quedan completamente fuera de este escenario: servidores MCP remotos, servidores que recuperan URLs arbitrarias y el modelo en sí.

    Más allá de este punto, el problema ya no se trata de una marca olvidada. Todos estos controles se aplican por contenedor, se escriben a mano y deben duplicarse para cada servidor añadido. Tres servidores requieren tres listas de permisos y tres cadenas de conjuntos de herramientas, y ningún componente supervisa la sesión en su totalidad.

    Lo que falta es una puerta de enlace ubicada entre el agente y sus servidores. Una puerta de enlace puede eliminar por completo una herramienta de list_tools e inspeccionar cada llamada nuevamente antes de transmitirla, de modo que la lista de herramientas se actualiza por sesión y no por archivo de configuración. Aún así, no puede observar el comportamiento de un servidor en ejecución: archivos abiertos, hosts contactados, credenciales leídas. Un servidor comprometido no necesita realizar ninguna llamada a herramientas para enviar claves a otro lugar. Una puerta de enlace añade otra capa adicional sin eliminar ninguna de las existentes.

    Reglas que se aplican a cualquier servidor local

    Las respuestas anteriores corresponden a GitHub. Las reglas que generan son aplicables a cualquier servidor local que vaya a ser incluido en una configuración:

    1. Utilice credenciales que caduquen. Una aplicación de GitHub es mejor que un token de acceso personal. El contenedor almacena una clave de firma y genera un token nuevo para cada uso, y ese token expira por sí solo en lugar de esperar a que alguien lo revierta.
    2. Defina los permisos por ámbito, no solo las credenciales. Un repositorio y cuatro permisos, siendo que cada token incluye exactamente esos.
    3. Seleccione cuidadosamente la red. Al no haber rutas predeterminadas, el proxy no es una configuración que el servidor pueda rechazar, mientras que -e HTTPS_PROXY es simplemente una solicitud.
    4. Cree una lista blanca de destinos. Un único host, api.github.com. Las credenciales robadas de ese contenedor no pueden usarse en otro lugar, y cada intento queda registrado en los logs de cualquier forma.
  • Privilegios reducidos. Ejecútelo como usuario no root con --user 10001, elimina las capacidades con --cap-drop ALL, agrega --security-opt no-new-privileges y monta el sistema de archivos en modo --read-only utilizando un tmpfs para los archivos temporales.
  • Exponer solo lo mínimo en el disco. Asigna a este servidor una única ruta, /key.pem:ro, y sin espacio de trabajo. Vincular $HOME a un contenedor no se considera aislamiento de seguridad.
  • Reducir la lista de herramientas. --toolsets excluye ciertos grupos y --exclude-tools elimina lo que queda, reduciendo el número de herramientas en este servidor de 42 a 37, de las cuales 15 siguen pudiendo escribir.
  • Imágenes de referencia por resumen. Evite latest y también las etiquetas de versión, ya que una etiqueta puede ser reorientada. Ambas imágenes en esta configuración, incluido el proxy, utilizan @sha256:… para que no puedan modificarse.
  • Ninguna regla única determina si ocurre daño. Un documento envenenado aún puede persuadir al agente para que realice una llamada a una herramienta. Cada regla limita hasta dónde puede extenderse una explosión y ninguna bloquea el disparador. Un entorno aislado regula dónde puede hablar un programa, pero nunca lo que dice.

    La lista de permisos ilustra el límite. Verifica que el tráfico se dirija a api.github.com pero no revela nada sobre el contenido. contents: write permite al agente enviar un branch, y también permite que una instrucción inyectada cometa un archivo. Los nombres de los branches, los mensajes de commit y los títulos de los issues parecen estar bien por separado, pero juntos pueden introducir cualquier cosa en un repositorio que otros puedan leer. Cualquier filtro lo suficientemente permisivo como para que el agente funcione permite que los datos salgan, ya que el trabajo en sí consiste en leer y escribir en GitHub.

    Por lo tanto, considere todo esto como la capa inicial, no como la meta final, y establezcalo primero. El costo son siete preguntas, unos diez minutos de lectura y una única llamada a tools/list. A cambio, se obtiene una configuración que se puede proteger, mientras que antes había tres líneas pegadas al azar.

    Leer más

  • Un modelo de 270M para preguntas multi-hop: pérdidas de precisión y éxitos locales — Un Gemma-3-270M ajustado a medida elige la primera búsqueda para las preguntas multi-hop, obteniendo una puntuación de 81 de 95. Perde frente a modelos más grandes en precisión, pero gana en costo, privacidad y uso sin conexión.