Stata MCP

Desde la línea de comandos

# VS Code
code --install-extension DeepEcon.stata-mcp

# Cursor
cursor --install-extension DeepEcon.stata-mcp

# Antigravity (installs from Open VSX Registry)
antigravity --install-extension DeepEcon.stata-mcp

Desde un archivo .vsix local

Descarga stata-mcp-<version>.vsix desde la página de versiones y luego:

code        --install-extension path/to/stata-mcp-0.5.3.vsix
cursor      --install-extension path/to/stata-mcp-0.5.3.vsix
antigravity --install-extension path/to/stata-mcp-0.5.3.vsix

…o en la interfaz: vista de Extensiones → menú … → Instalar desde VSIX… → selecciona el archivo descargado.

Registros

• VS Code Marketplace: https://marketplace.visualstudio.com/items?itemName=DeepEcon.stata-mcp
• Open VSX (Cursor / Antigravity): https://open-vsx.org/extension/DeepEcon/stata-mcp

Personaliza el comportamiento de la extensión mediante la configuración de VS Code. Accede a esta configuración a través de:

• VS Code/Cursor/Antigravity: Archivo > Preferencias > Configuración (o Ctrl+, / Cmd+,)
• Busca "Stata MCP" para encontrar toda la configuración de la extensión

Configuración principal

Configuración del servidor

Configuración de gráficos

Configuración de archivos de registro

Configuración avanzada

Configuración del directorio de trabajo

Controla qué directorio usa Stata al ejecutar archivos .do:

Ejemplo: Si la estructura de tu proyecto es project/code/analysis.do y tu archivo do espera ejecutarse desde project/, configura workingDirectory en parent.

Configuración de salida MCP

Esta configuración controla cómo se devuelve la salida de Stata a los asistentes de IA (LLM) mediante el protocolo MCP, lo que ayuda a reducir el uso de tokens:

El modo compacto filtra:

• Ecos de código de bucles (bloques foreach/forvalues/while): conserva solo la salida real
• Definiciones de programas y bloques de Mata
• Ecos de comandos y continuaciones de línea (solo para run_file)
• Mensajes detallados como "(N real changes made)" y "(N missing values generated)"

Configuración de múltiples sesiones

Habilita la ejecución paralela de Stata con sesiones aisladas. Cada sesión tiene sus propios datos, variables y macros.

Nota: Cada sesión requiere ~200-300 MB de RAM para Stata. Consulta tu licencia de Stata para conocer los límites de instancias concurrentes.

GitHub Copilot admite MCP (Protocolo de Contexto de Modelos) a partir de VS Code 1.102. Puedes conectar el servidor Stata MCP a Copilot para el desarrollo de Stata con asistencia de IA.

Configuración

1. Instala la extensión Stata MCP en VS Code (consulta la sección Instalación anterior)

2. Inicia el servidor Stata MCP: El servidor debería iniciarse automáticamente cuando abras VS Code con la extensión instalada. Verifica que esté en ejecución revisando la barra de estado (debería mostrar "Stata").

3. Añade el servidor MCP de Stata MCP a Copilot: Puedes configurar servidores MCP por espacio de trabajo o globalmente.

   Opción A: Configuración por espacio de trabajo

   Crea un archivo .vscode/mcp.json en la raíz de tu espacio de trabajo:

   {
     "servers": {
       "stata-mcp": {
         "type": "http",
         "url": "http://localhost:4000/mcp-streamable"
       }
     }
   }
   

   Opción B: Configuración global (todos los espacios de trabajo)

   1. Abre la Paleta de comandos (Ctrl+Shift+P / Cmd+Shift+P)
   2. Escribe "MCP: Open User Configuration" y selecciónalo
   3. Añade el servidor MCP de Stata MCP al archivo mcp.json:

      {
        "servers": {
          "stata-mcp": {
            "type": "http",
            "url": "http://localhost:4000/mcp-streamable"
          }
        }
      }
      

   En versiones anteriores de VS Code sin soporte para Streamable HTTP, usa "type": "sse" con http://localhost:4000/mcp en su lugar.

   El archivo mcp.json a nivel de usuario se encuentra en:

   • Windows: %APPDATA%\Code\User\mcp.json
   • macOS: ~/Library/Application Support/Code/User/mcp.json
   • Linux: ~/.config/Code/User/mcp.json

4. Recarga VS Code para aplicar la configuración.

5. GitHub Copilot ahora tendrá acceso a las herramientas de Stata y podrá ayudarte a:

   • Escribir y ejecutar comandos de Stata
   • Analizar tus datos
   • Generar visualizaciones
   • Depurar código de Stata
   • Crear informes estadísticos

Verificación de la conexión

1. Abre GitHub Copilot Chat (Ctrl+Shift+I / Cmd+Shift+I)
2. Escribe @mcp para ver las herramientas MCP disponibles
3. Las herramientas de Stata (stata_run_selection, stata_run_file) deberían aparecer

Solución de problemas

Si Copilot no reconoce el servidor MCP de Stata MCP:

1. Verifica que la versión de VS Code sea 1.102 o posterior
2. Verifica que el servidor MCP esté en ejecución (la barra de estado debería mostrar "Stata")
3. Comprueba que .vscode/mcp.json exista con el contenido correcto
4. Intenta reiniciar VS Code
5. Revisa el panel de salida de la extensión (View > Output > Stata MCP) para ver si hay errores
6. Asegúrate de que MCP esté habilitado en la política de Copilot de tu organización (si corresponde)

Claude Code es el asistente oficial de codificación con IA de Anthropic, disponible en VS Code, Cursor y Antigravity. Sigue estos pasos para configurar el servidor MCP de Stata MCP:

Instalación

1. Instala la extensión Stata MCP en VS Code, Cursor o Antigravity (consulta la sección Instalación anterior)

2. Inicia el servidor MCP de Stata MCP: El servidor debería iniciarse automáticamente al abrir tu IDE con la extensión instalada. Verifica que esté en ejecución revisando la barra de estado (debería mostrar "Stata").

Configuración

Una vez que el servidor MCP de Stata MCP esté en ejecución, configura Claude Code para conectarse a él:

1. Abre tu terminal o paleta de comandos

2. Ejecuta el siguiente comando para añadir el servidor MCP de Stata MCP:

   claude mcp add --transport http stata-mcp http://localhost:4000/mcp-streamable --scope user
   

   Las versiones anteriores de Claude Code (anteriores a 2026) pueden no reconocer --transport http. En esas, usa --transport sse con http://localhost:4000/mcp en su lugar. Claude Code ahora trata SSE como legado — prefiere http siempre que sea compatible.

3. Reinicia tu IDE

4. Claude Code ahora tendrá acceso a las herramientas de Stata y podrá ayudarte a:

   • Escribir y ejecutar comandos de Stata
   • Analizar tus datos
   • Generar visualizaciones
   • Depurar código de Stata
   • Crear informes estadísticos

Verificación de la conexión

Para verificar que Claude Code esté correctamente conectado al servidor MCP de Stata MCP:

1. Abre un archivo .do de Stata o crea uno nuevo
2. Pide a Claude Code que te ayude con una tarea de Stata (por ejemplo, "Carga el conjunto de datos auto y muestra estadísticas resumidas")
3. Claude Code debería poder ejecutar comandos de Stata y mostrar resultados

Solución de problemas

Si Claude Code no reconoce el servidor MCP de Stata MCP:

1. Verifica que el servidor MCP esté en ejecución (la barra de estado debería mostrar "Stata")
2. Comprueba que ejecutaste el comando claude mcp add con la URL correcta
3. Intenta reiniciar tu IDE
4. Revisa el panel de salida de la extensión (View > Output > Stata MCP) para ver si hay errores
5. Asegúrate de que no haya conflictos de puertos (el puerto predeterminado es 4000)

Claude Desktop se conecta a servidores MCP remotos como el que expone esta extensión. Asegúrate de que la extensión Stata MCP esté instalada y que su barra de estado muestre "Stata" antes de configurar Claude Desktop.

Opción A (recomendada): añadir como conector personalizado

1. Abre Claude Desktop → Configuración → Conectores → Añadir conector personalizado
2. Nombre: Stata MCP
3. URL: http://localhost:4000/mcp-streamable
4. Guarda y reinicia Claude Desktop

No se requiere envoltorio, ni edición de archivos de configuración, ni instalación de Python/Node. Esta es la forma actual recomendada por Anthropic para añadir servidores MCP remotos a Claude Desktop.

Opción B: Configuración JSON con un envoltorio stdio (si prefieres editar claude_desktop_config.json)

La configuración JSON de Anthropic aún no acepta URLs remotas directamente — todavía necesitas un envoltorio stdio local. La forma más fácil es mcp-remote, que no requiere instalación si tienes Node:

1. Abre el archivo de configuración:

   • macOS: ~/Library/Application Support/Claude Desktop/claude_desktop_config.json
   • Windows: %APPDATA%\Claude Desktop\claude_desktop_config.json

2. Añade este bloque (combínalo con cualquier objeto mcpServers existente):

   {
     "mcpServers": {
       "stata-mcp": {
         "command": "npx",
         "args": ["-y", "mcp-remote", "http://localhost:4000/mcp-streamable"]
       }
     }
   }
   

3. Reinicia Claude Desktop. Las herramientas de Stata aparecerán en la lista de herramientas disponibles.

Puedes usar esta extensión con OpenAI Codex — la CLI y todas las extensiones de IDE comparten el mismo ~/.codex/config.toml. Codex CLI 0.46.0+ (octubre de 2025) admite servidores MCP sobre HTTP de forma nativa, por lo que no se necesita envoltorio. Puedes usarlo desde la línea de comandos:

codex mcp add stata-mcp --url http://localhost:4000/mcp-streamable

O añade este bloque manualmente a ~/.codex/config.toml (o %USERPROFILE%\.codex\config.toml en Windows):

[mcp_servers.stata-mcp]
url = "http://localhost:4000/mcp-streamable"

¿Actualizando desde una configuración anterior? Si un bloque [mcp_servers.stata-mcp] existente usa command = "mcp-proxy" (o command = "uvx" + mcp-proxy en argumentos), elimina ese bloque antes de añadir el anterior — TOML prohíbe claves duplicadas, y Codex omitirá silenciosamente el servidor si ambos están presentes.

Luego reinicia Codex — las herramientas stata_run_selection y stata_run_file aparecerán. Ejecuta codex mcp list para confirmar que el servidor está registrado.

Nota sobre transportes. Codex solo habla el transporte Streamable HTTP de MCP (un único endpoint en /mcp-streamable). El endpoint SSE heredado de la extensión (/mcp) es para clientes más antiguos como GitHub Copilot — no apuntes Codex a él.

Solución de problemas de configuración de Codex

Si Codex no ve las herramientas de Stata:

1. Verifica que el servidor MCP esté en ejecución (la barra de estado muestra "Stata") — prueba curl -s http://localhost:4000/health
2. Comprueba codex --version — asegúrate de estar en 0.46.0 o más reciente. Las versiones anteriores de Codex necesitan el envoltorio mcp-proxy (consulta la nota a continuación).
3. Verifica que el archivo de configuración exista en ~/.codex/config.toml y contenga el bloque [mcp_servers.stata-mcp] exacto anterior
4. Ejecuta codex mcp list — stata-mcp debería aparecer como registrado
5. Reinicia Codex (CLI o IDE) después de los cambios de configuración
6. Revisa el panel de salida de la extensión (View → Output → Stata) para ver si hay errores del lado del servidor
7. Asegúrate de que no haya conflictos de puertos (el predeterminado es 4000 — cámbialo mediante stata-vscode.mcpServerPort si es necesario)

# Install uv first if needed:
curl -LsSf https://astral.sh/uv/install.sh | sh   # macOS/Linux
# Windows: powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

[mcp_servers.stata-mcp]
command = "uvx"
args = ["mcp-proxy", "http://localhost:4000/mcp"]

1. Abre tu archivo de configuración MCP de Cline:

   • macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Windows: %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

2. Añade la configuración del servidor MCP de Stata MCP:

   {
     "mcpServers": {
       "stata-mcp": {
         "url": "http://localhost:4000/mcp-streamable"
       }
     }
   }
   

   Cline detecta automáticamente el transporte desde la URL — no se necesita la clave transport. Apúntalo a http://localhost:4000/mcp si necesitas SSE por cualquier motivo.

3. Si el archivo ya contiene otros servidores MCP, solo añade la entrada "stata-mcp" al objeto "mcpServers" existente.

4. Guarda el archivo y reinicia VS Code.

También puedes configurar Cline a través de la configuración de VS Code:

"cline.mcpSettings": {
  "stata-mcp": {
    "url": "http://localhost:4000/mcp-streamable"
  }
}

Solución de problemas de configuración de Cline

Si Cline no reconoce el servidor MCP de Stata MCP:

1. Verifica que el servidor MCP esté en ejecución (la barra de estado debería mostrar "Stata")
2. Comprueba que el archivo de configuración exista con el contenido correcto
3. Intenta reiniciar VS Code
4. Revisa el panel de salida de la extensión (View > Output > Stata MCP) para ver si hay errores

La extensión configura automáticamente la integración MCP de Cursor. Para verificar que funciona:

1. Abre Cursor
2. Presiona Ctrl+Shift+P (o Cmd+Shift+P en Mac) para abrir la Paleta de comandos
3. Escribe "Stata: Test MCP Server Connection" y presiona Enter
4. Deberías ver un mensaje de éxito si el servidor está correctamente conectado

Rutas de archivos de configuración de Cursor

Cursor lee la configuración MCP a nivel de usuario desde:

• macOS / Linux: ~/.cursor/mcp.json
• Windows: %USERPROFILE%\.cursor\mcp.json

La configuración a nivel de espacio de trabajo (anula la de nivel de usuario para ese proyecto) va en .cursor/mcp.json en la raíz del espacio de trabajo.

Configuración manual de Cursor

Si necesitas configurar manualmente el MCP de Cursor:

1. Crea o edita el archivo de configuración MCP:

   • macOS/Linux: ~/.cursor/mcp.json
   • Windows: %USERPROFILE%\.cursor\mcp.json

2. Añade la configuración del servidor MCP de Stata MCP:

   {
     "mcpServers": {
       "stata-mcp": {
         "url": "http://localhost:4000/mcp-streamable"
       }
     }
   }
   

   Cursor detecta automáticamente el transporte desde la URL — no se necesita la clave transport. Intenta Streamable HTTP primero y recurre a SSE si el servidor lo anuncia.

3. Si el archivo ya contiene otros servidores MCP, solo añade la entrada "stata-mcp" al objeto "mcpServers" existente.

4. Guarda el archivo y reinicia Cursor.

Solución de problemas de configuración de Cursor

Si Cursor no reconoce el servidor MCP de Stata MCP:

1. Verifica que el servidor MCP esté en ejecución
2. Comprueba que el archivo de configuración exista con el contenido correcto
3. Intenta reiniciar Cursor
4. Asegúrate de que no haya conflictos de puertos con otras aplicaciones en ejecución

Esta extensión usa uv, un instalador de paquetes de Python rápido escrito en Rust, para gestionar las dependencias de Python. Características clave:

• Configuración automática de Python y gestión de dependencias
• Crea entornos aislados que no entrarán en conflicto con tu sistema
• Funciona en Windows, macOS y Linux
• 10-100 veces más rápido que las instalaciones tradicionales de pip

Si encuentras algún error relacionado con UV durante la instalación:

1. Instala UV manualmente:

   # Windows (PowerShell as Administrator)
   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
   
   # macOS/Linux
   curl -LsSf https://astral.sh/uv/install.sh | sh
   

2. Sigue los pasos de reinstalación limpia en la guía de solución de problemas para reinstalar la extensión.