MCP-for-Stata: Integrate Stata into your agent

MCP-for-Stata: Integra Stata en tu agente

Stata es una marca registrada de StataCorp LLC. Este proyecto es una herramienta independiente desarrollada por la comunidad y no esta afiliada, respaldada ni patrocinada por StataCorp LLC.

Notas: Aunque nos esforzamos por hacer que el codigo abierto sea accesible para todos, lamentamos no poder mantener ya la licencia Apache-2.0. Debido a que algunas personas han copiado directamente este proyecto y se han atribuido ser sus mantenedores, hemos decidido cambiar la licencia a AGPL-3.0 para evitar usos indebidos del proyecto que vayan en contra de nuestra vision original.

Motivo

Antecedentes: El repositorio de @jackdark425 copio directamente este proyecto y afirmo ser el unico mantenedor. Damos la bienvenida a la colaboracion de codigo abierto basada en forks, incluyendo pero no limitado a agregar nuevas funcionalidades, corregir errores existentes o proporcionar sugerencias valiosas para el proyecto, pero nos oponemos firmemente al plagio y a la atribucion falsa.

Actualizacion: El proyecto infractor ha sido retirado mediante DMCA de GitHub. Haz clic aqui para saber mas.

Novedades:

Encuentra mas en WeChat: Why I made it?, y 8 figures find out Stata-MCP
🦞 Soporte para OpenClaw: Herramientas CLI independientes para la integracion con OpenClaw (stata-mcp tool), consulta la guia de OpenClaw
✨ Soporte para plugin de Claude Code: Paquete oficial de plugin con servidor MCP e integracion con Stata LSP
Usa MCP-for-Stata en Claude Code, mira aqui, o Codex aqui

¿Buscas nuestra investigacion mas reciente? Haz clic aqui o visita el sitio web de reportes.

¿Buscas otros?

MCP o IA sobre Stata

Un servidor MCP basado en sesiones para Stata, mcp-stata

IDEs (VScode o Cursor) integrados aqui. ¿Confundido? 💡 Comparacion

Conjuntos de datos e informacion

STOP Dataset: StataMCP-Team Opendata Project 📊, hemos publicado de forma abierta una coleccion integral de conjuntos de datos para la investigacion en ciencias sociales, con el objetivo de impulsar el futuro de los paradigmas de investigacion impulsados por IA y datos.

Trace DID: Si deseas obtener la informacion mas reciente sobre DID (Diferencias en Diferencias), haz clic aqui. Ahora hay una traduccion al chino realizada por Sepine Tam y StataMCP-Team 🎉

Uso de Jupyter Lab (Importante: Stata 17+) aqui y nbstata

💡 Inicio rapido

🚀 ¡Instalación con un clic para todos los clientes!

Sin configuración ni edición manual de JSON. Un solo comando instala MCP-for-Stata para todos los agentes compatibles (Claude Code, Codex, OpenClaw, Cursor, Gemini CLI y más):

uvx stata-mcp install --all

Agentes soportados 🤖

Basado en nuestra propia experiencia y pruebas, recomendamos usar Claude Code, Codex y OpenClaw. Hemos descubierto que Claude y DeepSeek son los dos mejores modelos en cualquier framework.

Agente	Etiqueta	Comando
Claude Desktop	claude	uvx stata-mcp install -c claude
Claude Code	cc	uvx stata-mcp install -c cc
Gemini CLI	gemini	uvx stata-mcp install -c gemini
Cursor	cursor	uvx stata-mcp install -c cursor
Cline (VScode Extension)	cline	uvx stata-mcp install -c cline
Codex CLI & Codex Desktop	codex	uvx stata-mcp install -c codex
OpenCode	opencode	uvx stata-mcp install -c opencode
OpenClaw	openclaw	uvx stata-mcp install -c openclaw

Si no tienes uv, visita aqui para instalarlo. O bien, usa nuestro script de instalacion beta (instala uv automaticamente si falta):

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/SepineTam/mcp-for-stata/master/scripts/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/SepineTam/mcp-for-stata/master/scripts/install.ps1 | iex

Si no sabes como usarlos, intenta hacer clic aqui y descarga los scripts de instalacion y haz doble clic en tu dispositivo. install.bat para usuarios de Windows, y install.command para usuarios de macOS.

Avanzado - Claude Code

Dado que consideramos que Claude Code es el mejor agente para MCP-for-Stata por su excelente capacidad agentica, lo recomendamos, y hay muchos usos avanzados a continuacion:

Antes de usarlo, asegurate de haber instalado Claude Code, si no sabes como instalarlo, visita GitHub

En general, puedes instalar MCP-for-Stata globalmente una sola vez, puedes ejecutar:

claude mcp add stata-mcp --scope user -- uvx stata-mcp

Luego, no necesitas volver a verlo.

Local y compartir con tus colaboradores

Si deseas instalarlo localmente solo para un espacio de trabajo especifico, puedes hacer cd a tu directorio de trabajo y ejecutar:

claude mcp add stata-mcp --env STATA_MCP__CWD=$(pwd) --scope local -- uvx --directory $(pwd) stata-mcp

No pasara nada, puedes escribir claude y escribir /mcp para encontrar el estado.

Ademas, la colaboracion es una parte esencial de la investigacion. Puedes compartir tu configuracion de MCP con tus coautores usando:

claude mcp add stata-mcp --scope project -- uvx stata-mcp

En tu directorio de trabajo, puedes encontrar un archivo llamado .mcp.json, tu configuracion de MCP se colocara aqui.

Luego, puedes usar MCP-for-Stata en Claude Code. Aqui hay algunos escenarios para usarlo:

Replicacion de articulos: Replicar estudios empiricos de articulos de economia
Prueba rapida de hipotesis: Validar hipotesis economicas mediante analisis de regresion
Asistente de aprendizaje de Stata: Aprender econometria con explicaciones paso a paso en Stata
Organizacion de codigo: Revisar y optimizar archivos do existentes de Stata
Interpretacion de resultados: Comprender salidas estadisticas complejas y resultados de regresion

Si usas Claude Code dentro de IDEs (ya sea el terminal integrado o la Extension de Claude Code), instala nuestro plugin que incluye MCP-for-Stata y Stata LSP mantenido por @euglevi.

# Agrega el marketplace de MCP-for-Stata
claude plugin marketplace add SepineTam/mcp-for-stata

# Instala el plugin en alcance local, de proyecto o de usuario
claude plugin install stata-toolbox -s project

El servidor de lenguaje proporciona a los agentes de IA una mejor conciencia sintactica y completado de codigo Stata, lo que mejora la calidad de la salida. Empaquetamos el LSP en cumplimiento con su licencia y damos plena atribucion al autor original.

Avanzado - Codex

Descubrimos que muchos investigadores estan usando Codex como su agente, por lo tanto tambien proporcionamos instrucciones para usuarios de Codex.

Imagino que los investigadores no estan usando Codex CLI sino Codex Desktop, asi que podemos decir que es mas facil configurar MCP-for-Stata que otros agentes.

Solo necesitas decir Install MCP-for-Stata for yourself globally from https://www.statamcp.com or visit https://github.com/SepineTam/mcp-for-stata y luego reiniciar tu Codex Desktop despues de que diga listo.

Ademas, si deseas instalarlo manualmente, aqui hay dos formas:

A. Instalar en la GUI de Codex Desktop

Abre tu aplicacion Codex Desktop
Haz clic en Settings en la esquina inferior izquierda
Encuentra MCP servers en el lado izquierdo
Haz clic en Add server

Rellena con lo siguiente:

Name: stata-mcp
Command to launch: uvx
Arguments: stata-mcp

Haz clic en Save
Luego, reinicia tu Codex Desktop y disfrutalo.

B. Instalar con Codex CLI

Para el modo CLI, simplemente ejecuta el siguiente comando en tu terminal

uvx stata-mcp install -c codex

O usa

codex mcp add stata-mcp -- uvx stata-mcp

Otros clientes

Configuracion estandar requerida: asegurate de que Stata este instalado en la ruta predeterminada, y que la CLI de Stata (para macOS y Linux) exista.

La configuracion JSON estandar es la siguiente, puedes personalizar tu configuracion agregando variables de entorno.

{
  "mcpServers": {
    "stata-mcp": {
      "command": "uvx",
      "args": [
        "stata-mcp"
      ]
    }
  }
}

Para obtener informacion de uso mas detallada, visita la guia de uso.

Requisitos previos

uv - Instalador de paquetes y gestor de entornos virtuales
Claude Code, Codex, OpenClaw u otros Agentes
Licencia de Stata
Tu API-KEY de LLM

Si deseas verificar si tu dispositivo es compatible, puedes ejecutar:

uvx stata-mcp doctor

Muestra informacion basica sobre tu dispositivo y verifica si tu configuracion es compatible.

Ejemplo de salida

stata-mcp v1.17.0 — Doctor Report

  [PASS] os: macOS (Darwin 25.3.0, arm64)
  [PASS] python: 3.13.5
  [PASS] uv: uv 0.11.13
  [PASS] dependencies: all required packages available
  [PASS] stata_cli: /usr/local/bin/stata-mp (from env)
  [PASS] stata_execution: OK (0.1s)
  [PASS] config: /Users/sepinetam/.statamcp/config.toml (loaded)
  [PASS] working_dir: /Users/sepinetam/Documents/Github/stata-mcp (writable)
  [PASS] guard: enabled, loaded 27 rules
  [PASS] monitor: disabled (psutil available)
  [PASS] pypi: reachable (4.86s)
  [PASS] cleanup: 0 old files (0 B) found; cleanup disabled (CLEAN_LOG_DAYS=-1)

Summary: 12 passed, 0 failed, 0 warning(s), 0 skipped

Notas:

Si te encuentras en China, puedes encontrar un breve documento de uso de uv aqui.

Claude es la mejor opcion para MCP-for-Stata, para usuarios de chino, recomiendo usar DeepSeek como proveedor de modelo ya que es economico y potente, ademas tiene la puntuacion mas alta entre los proveedores de China, si te interesa, visita el reporte How to use StataMCP improve your social science research.

Comparacion

Existen varios proyectos MCP relacionados con Stata. La tabla siguiente fue generada por Claude Code despues de analizar directamente cada base de codigo.

Caracteristica	MCP-for-Stata (este)	hanlulong/stata-mcp	tmonk/mcp-stata
Agentes	Todos	La ventana de VSCode debe permanecer activa	Todos
Tipo	Servidor MCP + toolkit CLI	Extension de VSCode (servidor localhost, no MCP independiente)	Servidor MCP basado en sesiones
Ejecucion	do-file via subprocess	Ejecutor integrado en IDE via localhost :4000	pystata (Stata 17+)
Seguridad	Guardia de comandos + monitor de RAM	—	—
Analisis de datos	Manejadores CSV, DTA, XLSX, SPSS	—	`describe` / `codebook` en sesion
Registros	Lectores de texto + SMCL	—	Lector de registros integrado
Graficos	—	—	Exportar, cache, SVG/PNG
Soporte CLI	Nativo (mismas herramientas que el servidor MCP)	—	—
Sesiones	—	—	Multi-sesion, tareas en segundo plano
Plugin de IDE	—	VSCode / Cursor nativo	Stata Workbench (VS Code)
Instalacion	`uvx stata-mcp install`	VS Code Marketplace	`uvx` o script de instalacion
Mejor para	Analisis impulsado por agentes (Claude Code, Codex, OpenClaw)	Usuarios que escriben y ejecutan codigo Stata dentro de VSCode ellos mismos	Flujos de trabajo de investigacion (replicacion, robustez, QA de publicacion)

📝 Documentacion

Los documentos de MCP-for-Stata estan en https://docs.statamcp.com

Documentacion principal

Documentacion completa: Sitio de documentacion completo con todas las funcionalidades
Guia de configuracion: Sistema de configuracion unificado basado en TOML
Guardia de seguridad: Validacion de seguridad para comandos peligrosos
Sistema de monitoreo: Monitoreo de RAM y limites de recursos
Vision general de la arquitectura: Diseno del sistema y patrones de integracion

Caracteristicas clave

Guardia de seguridad: Bloquea comandos peligrosos (!, shell, erase, etc.)
Monitoreo de RAM: Previene el agotamiento de memoria con limites configurables
Configuracion unificada: Configuracion TOML + variables de entorno
Soporte multiplataforma (macOS, Windows, Linux)
Captura automatica de registros y reporte de errores

🐛 Reportar problemas

Si encuentras algun error o tienes solicitudes de funcionalidades, por favor abre un issue.

📄 Licencia

Licencia Publica General Affero de GNU v3.0

📚 Citacion

Si usas MCP-for-Stata en tu investigacion y realmente te ayuda, puedes citar este repositorio usando uno de los siguientes formatos:

BibTeX

@software{sepinetam2025stata,
  author = {Song Tan},
  title = {MCP-for-Stata: Integrate Stata into your agent},
  year = {2025},
  url = {https://github.com/sepinetam/mcp-for-stata},
  version = {1.18.0}
}

APA

Song Tan. (2025). MCP-for-Stata: Integrate Stata into your agent (Version 1.18.0) [Computer software]. https://github.com/sepinetam/mcp-for-stata

Chicago

Song Tan. 2025. "MCP-for-Stata: Integrate Stata into your agent." Version 1.18.0. https://github.com/sepinetam/mcp-for-stata.

📬 Contacto

Correo electronico: sepinetam@gmail.com

O contribuye directamente enviando un Pull Request! Damos la bienvenida a contribuciones de todo tipo, desde correcciones de errores hasta nuevas funcionalidades.

📃 Declaracion

Stata es una marca registrada de StataCorp LLC. Este proyecto (MCP-for-Stata) es una herramienta de codigo abierto independiente y no esta afiliada, respaldada ni patrocinada por StataCorp LLC. Este proyecto no distribuye el software Stata, su codigo fuente ni ningun paquete de instalacion. Los usuarios deben comprar e instalar de forma independiente una copia con licencia valida de Stata de StataCorp LLC o de sus distribuidores autorizados.

Este proyecto esta licenciado bajo AGPL-3.0. Los mantenedores del proyecto no aceptan responsabilidad alguna por cualquier perdida o daño que surja unicamente del uso del codigo o la documentacion de este proyecto.

Mas informacion: consulta la version en chino en README.zh-CN.md; en caso de cualquier conflicto, prevalecera la version en chino.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

MCP-for-Stata: Integra Stata en tu agente

💡 Inicio rapido

🚀 ¡Instalación con un clic para todos los clientes!

Avanzado - Claude Code

Avanzado - Codex

A. Instalar en la GUI de Codex Desktop

B. Instalar con Codex CLI

Otros clientes

Requisitos previos

Comparacion

📝 Documentacion

Documentacion principal

Caracteristicas clave

🐛 Reportar problemas

📄 Licencia

📚 Citacion

BibTeX

APA

Chicago

📬 Contacto

📃 Declaracion

✨ Historial de estrellas

FilesExpand file tree

README.es.md

Latest commit

History

README.es.md

File metadata and controls

MCP-for-Stata: Integra Stata en tu agente

💡 Inicio rapido

🚀 ¡Instalación con un clic para todos los clientes!

Avanzado - Claude Code

Avanzado - Codex

A. Instalar en la GUI de Codex Desktop

B. Instalar con Codex CLI

Otros clientes

Requisitos previos

Comparacion

📝 Documentacion

Documentacion principal

Caracteristicas clave

🐛 Reportar problemas

📄 Licencia

📚 Citacion

BibTeX

APA

Chicago

📬 Contacto

📃 Declaracion

✨ Historial de estrellas