Stata est une marque deposee de StataCorp LLC. Ce projet est un outil independant developpe par la communaute et n'est ni affilie, ni approuve, ni sponsorise par StataCorp LLC.
Notes : Bien que nous nous efforcions de rendre l'open source accessible a tous, nous regrettons de ne plus pouvoir maintenir la licence Apache-2.0. En raison de personnes ayant directement copie ce projet et pretendu en etre les mainteneurs, nous avons decide de changer la licence pour AGPL-3.0 afin d'empecher toute utilisation abusive du projet allant a l'encontre de notre vision initiale.
Raison
Contexte : Le depot de @jackdark425 a directement copie ce projet et pretendu en etre le seul mainteneur. Nous accueillons favorablement la collaboration open source basee sur des forks, y compris mais sans s'y limiter l'ajout de nouvelles fonctionnalites, la correction de bugs existants ou la formulation de suggestions precieuses pour le projet, mais nous nous opposons fermement au plagiat et a l'attribution frauduleuse.
Mise a jour : Le projet contrefaisant a ete retire via GitHub DMCA. Cliquez ici pour en savoir plus.
Actualites :
- Retrouvez-nous sur WeChat : Why I made it?, et 8 figures find out Stata-MCP
- π¦ Support OpenClaw : Outils CLI autonomes pour l'integration OpenClaw (
stata-mcp tool), consultez le guide OpenClaw - β¨ Support du plugin Claude Code : Package officiel de plugin avec serveur MCP et integration Stata LSP
- Utilisez MCP-for-Stata dans Claude Code, consultez ici, ou Codex ici
Vous cherchez nos dernieres recherches ? Cliquez ici ou visitez le site des rapports.
Vous cherchez d'autres outils ?
MCP ou IA concernant Stata
- Un serveur MCP base sur les sessions pour Stata, mcp-stata
- IDE (VScode ou Cursor) integres ici. Vous les confondez ? π‘ Comparaison
Jeux de donnees et informations
- STOP Dataset : StataMCP-Team Opendata Project π, nous avons open-source une collection complete de jeux de donnees pour la recherche en sciences sociales, dans le but de favoriser l'avenir des paradigmes de recherche pilotee par l'IA et alimentee par les donnees.
- Trace DID : Si vous souhaitez obtenir les informations les plus recentes sur le DID (Difference-in-Difference), cliquez ici. Il existe maintenant une traduction en chinois par Sepine Tam et StataMCP-Team π
- Utilisation de Jupyter Lab (Important : Stata 17+) ici et nbstata
Aucune configuration, aucune Γ©dition manuelle de JSON. Une seule commande installe MCP-for-Stata pour tous les agents pris en charge (Claude Code, Codex, OpenClaw, Cursor, Gemini CLI et plus) :
uvx stata-mcp install --allAgents pris en charge π€
Sur la base de notre propre experience et de nos tests, nous recommandons d'utiliser Claude Code, Codex et OpenClaw. Nous avons constate que Claude et DeepSeek sont les deux meilleurs modeles quel que soit le framework.| Agent | Tag | Commande |
|---|---|---|
| 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 vous n'avez pas uv, visitez ici pour l'installer.
Ou utilisez notre script d'installation beta (installe automatiquement uv s'il manque) :
macOS / Linux :
curl -fsSL https://raw.githubusercontent.com/SepineTam/mcp-for-stata/master/scripts/install.sh | bashWindows (PowerShell) :
irm https://raw.githubusercontent.com/SepineTam/mcp-for-stata/master/scripts/install.ps1 | iexSi vous ne savez pas comment les utiliser, essayez de cliquer ici et telechargez les scripts d'installation, puis double-cliquez dessus sur votre appareil. install.bat pour les utilisateurs Windows, et install.command pour les utilisateurs macOS.
Comme nous avons constate que Claude Code est le meilleur agent pour MCP-for-Stata grace a ses capacites agentiques parfaites, nous recommandons de l'utiliser, et voici de nombreuses utilisations avancees :
Avant de l'utiliser, assurez-vous d'avoir deja installe Claude Code. Si vous ne savez pas comment l'installer, rendez-vous sur GitHub
En general, vous pouvez installer MCP-for-Stata globalement une seule fois, vous pouvez executer :
claude mcp add stata-mcp --scope user -- uvx stata-mcpEnsuite, vous n'aurez plus besoin de vous en occuper.
Local et partage avec vos partenaires
Si vous souhaitez l'installer localement uniquement pour un espace de travail specifique, vous pouvez vous rendre dans votre repertoire de travail avec cd, et executer :
claude mcp add stata-mcp --env STATA_MCP__CWD=$(pwd) --scope local -- uvx --directory $(pwd) stata-mcpIl ne se passera rien de visible, vous pouvez taper claude puis /mcp pour verifier le statut.
De plus, la collaboration est une partie essentielle de la recherche. Vous pouvez partager votre configuration MCP avec vos co-auteurs en utilisant :
claude mcp add stata-mcp --scope project -- uvx stata-mcpDans votre repertoire de travail, vous trouverez un fichier nomme .mcp.json, votre configuration MCP sera placee ici.
Ensuite, vous pouvez utiliser MCP-for-Stata dans Claude Code. Voici quelques scenarios d'utilisation :
- Replication d'articles : Repliquer des etudes empiriques issues d'articles d'economie
- Test rapide d'hypotheses : Valider des hypotheses economiques par analyse de regression
- Assistant d'apprentissage Stata : Apprendre l'econometrie avec des explications Stata etape par etape
- Organisation du code : Examiner et optimiser les do-files Stata existants
- Interpretation des resultats : Comprendre les sorties statistiques complexes et les resultats de regression
Si vous utilisez Claude Code dans des IDE (que ce soit le terminal integre ou l'extension Claude Code), installez notre plugin comprenant MCP-for-Stata et Stata LSP maintenu par @euglevi.
# Ajouter la marketplace MCP-for-Stata
claude plugin marketplace add SepineTam/mcp-for-stata
# Installer le plugin localement, par projet ou par utilisateur
claude plugin install stata-toolbox -s projectLe serveur de langage offre une meilleure conscience syntaxique et completion pour le code Stata genere par l'IA, ce qui ameliore la qualite des sorties. Nous empaquetons le LSP en conformite avec sa licence et attribuons pleinement l'auteur original.
Nous avons constate que de nombreux chercheurs utilisent Codex comme agent, c'est pourquoi nous fournissons egalement des instructions pour les utilisateurs de Codex.
Je suppose que les chercheurs n'utilisent pas Codex CLI mais Codex Desktop, nous pouvons donc dire qu'il est plus facile de configurer MCP-for-Stata que pour d'autres agents.
Vous avez juste besoin de dire Install MCP-for-Stata for yourself globally from https://www.statamcp.com or visit https://github.com/SepineTam/mcp-for-stata puis redemarrez votre Codex Desktop apres qu'il ait indique pret.
De plus, si vous souhaitez l'installer manuellement, voici deux methodes :
- Ouvrez votre application Codex Desktop
- Cliquez sur
Settingsdans le coin inferieur gauche - Trouvez
MCP serverssur le cote gauche - Cliquez sur
Add server - Remplissez avec les informations suivantes :
Name: stata-mcp Command to launch: uvx Arguments: stata-mcp - Cliquez sur
Save - Puis, redemarrez votre Codex Desktop et profitez-en.
Pour le mode CLI, executez simplement la commande suivante dans votre terminal :
uvx stata-mcp install -c codexOu utilisez :
codex mcp add stata-mcp -- uvx stata-mcpConfiguration standard requise : veuillez vous assurer que Stata est installe au chemin par defaut, et que le CLI Stata (pour macOS et Linux) existe.
La configuration JSON standard est la suivante, vous pouvez personnaliser votre configuration en ajoutant des variables d'environnement.
{
"mcpServers": {
"stata-mcp": {
"command": "uvx",
"args": [
"stata-mcp"
]
}
}
}Pour plus d'informations detaillees sur l'utilisation, consultez le Guide d'utilisation.
- uv - Gestionnaire d'installation de packages et d'environnements virtuels
- Claude Code, Codex, OpenClaw ou autres agents
- Licence Stata
- Votre cle API du LLM
Si vous souhaitez verifier si votre appareil est pris en charge, vous pouvez executer :
uvx stata-mcp doctorIl affiche les informations de base sur votre appareil et verifie si votre configuration est prise en charge.
Exemple de sortie
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 skippedNotes :
- Si vous vous trouvez en Chine, un court document d'utilisation de uv est disponible ici.
- Claude est le meilleur choix pour MCP-for-Stata. Pour les utilisateurs chinois, je recommande d'utiliser DeepSeek comme fournisseur de modele car il est bon marche et puissant, et obtient le meilleur score chez les fournisseurs chinois. Si cela vous interesse, consultez le rapport How to use StataMCP improve your social science research.
Il existe plusieurs projets MCP lies a Stata. Le tableau ci-dessous a ete genere par Claude Code apres analyse directe de chaque base de code.
| Fonctionnalite | MCP-for-Stata (ceci) | hanlulong/stata-mcp | tmonk/mcp-stata |
|---|---|---|---|
| Agents | Tous | La fenetre VSCode doit rester active | Tous |
| Type | Serveur MCP + boite a outils CLI | Extension VSCode (serveur localhost, pas MCP autonome) | Serveur MCP base sur les sessions |
| Execution | do-file via subprocess | Executeur integre a l'IDE via localhost :4000 | pystata (Stata 17+) |
| Securite | Garde de commandes + surveillance RAM | β | β |
| Analyse de donnees | Gestionnaires CSV, DTA, XLSX, SPSS | β | describe / codebook en session |
| Journaux | Lecteurs texte + SMCL | β | Lecteur de journal integre |
| Graphiques | β | β | Export, cache, SVG/PNG |
| Support CLI | Natif (memes outils que le serveur MCP) | β | β |
| Sessions | β | β | Multi-session, taches en arriere-plan |
| Plugin IDE | β | VSCode / Cursor natif | Stata Workbench (VS Code) |
| Installation | uvx stata-mcp install |
VS Code Marketplace | uvx ou script d'installation |
| Ideal pour | Analyse pilotee par agent (Claude Code, Codex, OpenClaw) | Utilisateurs qui ecrivent et executent du code Stata dans VSCode eux-memes | Flux de travail de recherche (replication, robustesse, QA publication) |
Les documents de MCP-for-Stata sont disponibles sur https://docs.statamcp.com
- Documentation complete : Site de documentation complet avec toutes les fonctionnalites
- Guide de configuration : Systeme de configuration unifie base sur TOML
- Garde de securite : Validation de securite pour les commandes dangereuses
- Systeme de surveillance : Surveillance RAM et limites de ressources
- Vue d'ensemble de l'architecture : Conception du systeme et modeles d'integration
- Garde de securite : Bloque les commandes dangereuses (
!,shell,erase, etc.) - Surveillance RAM : Empeche l'epuisement de la memoire avec des limites configurables
- Configuration unifiee : Configuration TOML + variables d'environnement
- Support multiplateforme (macOS, Windows, Linux)
- Capture automatique des journaux et rapport d'erreurs
Si vous rencontrez des bugs ou avez des demandes de fonctionnalites, veuillez ouvrir un ticket.
Licence publique generale Affero GNU v3.0
Si vous utilisez MCP-for-Stata dans votre recherche et qu'il vous aide vraiment, vous pouvez citer ce depot en utilisant l'un des formats suivants :
@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}
}Song Tan. (2025). MCP-for-Stata: Integrate Stata into your agent (Version 1.18.0) [Computer software]. https://github.com/sepinetam/mcp-for-stataSong Tan. 2025. "MCP-for-Stata: Integrate Stata into your agent." Version 1.18.0. https://github.com/sepinetam/mcp-for-stata.Email : sepinetam@gmail.com
Ou contribuez directement en soumettant une Pull Request ! Nous accueillons favorablement les contributions de toutes sortes, des corrections de bugs aux nouvelles fonctionnalites.
Stata est une marque deposee de StataCorp LLC. Ce projet (MCP-for-Stata) est un outil open-source independant et n'est ni affilie, ni approuve, ni sponsorise par StataCorp LLC. Ce projet ne distribue pas le logiciel Stata, son code source, ni aucun package d'installation. Les utilisateurs doivent acheter et installer independamment une copie valide et sous licence de Stata aupres de StataCorp LLC ou de ses distributeurs autorises.
Ce projet est sous licence AGPL-3.0. Les mainteneurs du projet n'acceptent aucune responsabilite pour toute perte ou dommage resultant uniquement de l'utilisation du code ou de la documentation de ce projet.
Plus d'informations : consultez la version chinoise sur README.zh-CN.md ; en cas de conflit, la version chinoise prevaut.