Stata-MCP

MCP-for-Stata: Integre o Stata ao seu agente

Permita que Claude Code, Codex, OpenClaw e outros agentes de IA invoquem o Stata com segurança no seu dispositivo local para análise de dados.

Stata é uma marca registrada da StataCorp LLC. Este projeto é uma ferramenta independente desenvolvida pela comunidade e não é afiliado, endossado ou patrocinado pela StataCorp LLC.

🆕 Novidades

• 🚀 Suporte desde o Dia 0 no DeepSeek Harness: Instale o MCP-for-Stata no DeepSeek Harness com uvx stata-mcp install -c dsh. Veja o guia do DeepSeek Harness.
• 🧪 Suporte ao Claude Science: O MCP-for-Stata agora funciona no Claude Science com uma lista de permissões de sandbox. Veja o guia do Claude Science.
• Encontre mais no WeChat: Por que eu fiz isso?, e 8 figuras para descobrir o Stata-MCP
• 🦞 Suporte ao OpenClaw: Ferramentas CLI autônomas para integração com OpenClaw (stata-mcp tool), veja o guia do OpenClaw
• ✨ Suporte a Plugin do Claude Code: Pacote de plugin oficial com servidor MCP e integração com Stata LSP
• Use o MCP-for-Stata no Claude Code, veja uso avançado do Claude Code, ou no Codex veja uso avançado do Codex

Procurando nossas pesquisas mais recentes? Veja os relatórios de pesquisa mais recentes.

💡 Início Rápido

🚀 Instalação com um clique para todos os clientes!

Sem configuração, sem edição manual de JSON. Apenas um comando instala o MCP-for-Stata para cada agente suportado (Claude Code, Codex, OpenClaw, Cursor, Gemini CLI e outros):

uvx stata-mcp install --all

Se você não tem uv, veja o guia de instalação do uv para instalá-lo. Ou use nosso script de instalação beta (instala automaticamente o uv se estiver ausente):

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

Se você não sabe como usá-los, baixe os scripts de instalação e clique duas vezes neles no seu dispositivo. install.bat para usuários Windows e install.command para usuários macOS.

Avançado - Claude Code

Como consideramos o Claude Code o melhor agente para o MCP-for-Stata devido à sua capacidade agêntica perfeita, recomendamos usá-lo, e há muitos usos avançados a seguir:

Antes de usá-lo, certifique-se de que você já instalou o Claude Code; se não souber como instalá-lo, visite o GitHub

Geralmente, você pode instalar o MCP-for-Stata globalmente uma única vez, executando:

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

Depois disso, você não precisa se preocupar novamente.

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

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

Então, você pode usar o MCP-for-Stata no Claude Code. Aqui estão alguns cenários de uso:

• Replicação de artigos: Replique estudos empíricos de artigos de economia
• Teste rápido de hipóteses: Valide hipóteses econômicas por meio de análise de regressão
• Assistente de aprendizado de Stata: Aprenda econometria com explicações passo a passo do Stata
• Organização de código: Revise e otimize arquivos do-files do Stata existentes
• Interpretação de resultados: Entenda saídas estatísticas complexas e resultados de regressão

Se você usa o Claude Code dentro de IDEs (seja o terminal integrado ou a Extensão do Claude Code), instale nosso plugin incluindo MCP-for-Stata e Stata LSP mantido por @euglevi.

# Add the MCP-for-Stata marketplace
claude plugin marketplace add SepineTam/mcp-for-stata

# Install the plugin to local, project or user scope
claude plugin install stata-toolbox -s project

O servidor de linguagem dá ao código Stata gerado por IA melhor consciência de sintaxe e conclusão, o que melhora a qualidade da saída. Empacotamos o LSP em conformidade com sua licença e damos total atribuição ao autor original.

Avançado - Codex

Descobrimos que muitos pesquisadores estão usando o Codex como seu agente, portanto, também fornecemos instruções para usuários do Codex.

Percebo que os pesquisadores não usam o Codex CLI, mas sim o Codex Desktop, então podemos dizer que é mais fácil configurar o MCP-for-Stata do que outros agentes.

Você só precisa dizer Install MCP-for-Stata for yourself globally from https://www.statamcp.com or visit https://github.com/SepineTam/mcp-for-stata e reiniciar seu Codex Desktop depois que ele disser que está pronto.

Além disso, se você quiser instalá-lo manualmente, aqui estão duas maneiras:

A. Instalar na GUI do Codex Desktop

1. Abra seu aplicativo Codex Desktop
2. Clique em Settings no canto inferior esquerdo
3. Encontre MCP servers no lado esquerdo
4. Clique em Add server
5. Preencha com o seguinte:

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

6. Clique em Save
7. Em seguida, reinicie seu Codex Desktop e aproveite.

B. Instalar com o Codex CLI

Para o modo CLI, basta executar o seguinte comando no seu terminal

uvx stata-mcp install -c codex

Ou use

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

Avançado - Claude Science

O Claude Science executa servidores MCP dentro de uma sandbox estrita que bloqueia o acesso ao diretório inicial (~) por padrão. Se você tentar iniciar o MCP-for-Stata da maneira padrão, poderá ver:

Couldn't load tools: MCP error -32000: Connection closed
FileNotFoundError: [Errno 2] No such file or directory

Para corrigir isso, adicione à lista de permissões os caminhos onde o uv tool install stata-mcp coloca seus arquivos. Crie ou edite ~/.claude-science/config.toml:

[sandbox]
user_write_paths = [
  "~/.local/bin",
  "~/.local/share/uv/tools/stata-mcp",
]

Em seguida, adicione o servidor no Claude Science:

• Nome: stata-mcp
• Comando: ~/.local/bin/stata-mcp

Reinicie o Claude Science e as ferramentas serão carregadas. Para o passo a passo completo, veja o guia do Claude Science.

Outros Clientes

Configuração padrão requer: certifique-se de que o stata esteja instalado no caminho padrão e que o cli do stata (para macOS e Linux) exista.

O json de configuração padrão é o seguinte; você pode personalizar sua configuração adicionando envs.

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

Para informações de uso mais detalhadas, visite o guia de uso.

Pré-requisitos

• uv - Instalador de pacotes e gerenciador de ambiente virtual
• Claude Code, Codex, OpenClaw ou outros agentes
• Licença do Stata
• Sua API-KEY do LLM

Se você quiser verificar se seu dispositivo é suportado, execute:

uvx stata-mcp doctor

Ele exibe informações básicas sobre seu dispositivo e verifica se sua configuração é suportada.

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:

1. Se você estiver na China e os downloads de pacotes estiverem lentos, veja a solução.
2. Claude é a melhor escolha para o MCP-for-Stata; para chinês, recomendo usar DeepSeek como seu provedor de modelo, pois é barato e poderoso, e também tem a pontuação mais alta entre os provedores chineses. Se você tiver interesse, veja o relatório Como usar o StataMCP para melhorar sua pesquisa em ciências sociais.

Comparação

Existem vários projetos MCP relacionados ao Stata. A tabela abaixo foi gerada pelo Claude Code após analisar cada base de código diretamente.

📝 Documentação

Para documentos do MCP-for-Stata, visite https://sepinetam.github.io/mcp-for-stata

Documentação Principal

• Documentação Completa: Site de documentação completo com todos os recursos
• Guia de Configuração: Sistema de configuração unificado baseado em TOML
• Guarda de Segurança: Validação de segurança para comandos perigosos
• Sistema de Monitoramento: Monitoramento de RAM e limites de recursos
• Visão Geral da Arquitetura: Design do sistema e padrões de integração

Principais Recursos

• Guarda de Segurança: Bloqueia comandos perigosos (!, shell, erase, etc.)
• Monitoramento de RAM: Previne esgotamento de memória com limites configuráveis
• Configuração em Camadas: Suporte a configuração de usuário, projeto, ambiente e sistema Linux
• Execução assíncrona stata_do em beta: Suporta chamadas MCP concorrentes para fluxos de trabalho multi-cliente
• Limites configuráveis de acesso a dados: Guarda de URL de informações de dados e limite direto opcional read_log
• Suporte multiplataforma (macOS, Windows, Linux)
• Captura automática de logs e relatório de erros

🐛 Reportar Problemas

Se você encontrar algum bug ou tiver solicitações de recursos, por favor abra uma issue.

📄 Licença

GNU Affero General Public License v3.0

📚 Citação

Se você usar o MCP-for-Stata em sua pesquisa e ele realmente ajudar você, pode citar este repositório usando um dos seguintes 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.22.0}
}

APA

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

Chicago

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

📬 Contato

E-mail: sepinetam@gmail.com

Ou contribua diretamente enviando um Pull Request! Aceitamos contribuições de todos os tipos, desde correções de bugs até novos recursos.

📃 Declaração

Stata é uma marca registrada da StataCorp LLC. Este projeto (MCP-for-Stata) é uma ferramenta independente de código aberto e não é afiliado, endossado ou patrocinado pela StataCorp LLC. Este projeto não distribui o software Stata, seu código-fonte ou qualquer pacote de instalação. Os usuários devem comprar e instalar de forma independente uma cópia licenciada válida do Stata da StataCorp LLC ou de seus distribuidores autorizados.

Este projeto é licenciado sob AGPL-3.0. Os mantenedores do projeto não aceitam responsabilidade por qualquer perda ou dano decorrente exclusivamente do uso do código ou documentação deste projeto.

Mais informações: consulte a versão chinesa em README.zh-CN.md; em caso de conflito, a versão chinesa prevalecerá.

✨ Histórico de Estrelas