Stata Econ MCP

让 Claude（Claude Desktop 聊天 / Claude Code）直接驱动你本机的 Stata 跑回归。

• 使用 Stata 官方自带的 pystata 引擎（<Stata 安装目录>/utilities/pystata），用的是你自己的 Stata、许可证和已安装的外部命令（reghdfe、csdid 等）。

• Stata 跑在独立子进程里，会话常驻：数据、estimates store、locals 在调用之间保留；卡死可 stata_restart。

• 内置应用计量知识包（面板 FE / DID / 错时 DID / DDD / 事件研究 / LaTeX 表 / 审稿标准），Claude 通过 stata_guide 读取。

环境要求

• Stata 17 或更高（MP / SE / BE），已在本机安装并激活许可证

• uv（或 Python 3.11+）

• 已在 macOS (Apple Silicon) + Stata 18 MP 上测试；Linux / Windows 理论可用但未测试，需要设置 STATA_DIR

Related MCP server: io.github.aliveranme/stata-mcp

安装

git clone https://github.com/shanyuzhang/stata-econ-mcp.git
cd stata-econ-mcp
uv sync

可执行文件位于 <仓库路径>/.venv/bin/stata-econ-mcp（下文记为 <SERVER>，请填绝对路径）。

接入 Claude Code

claude mcp add stata --scope user -- "<SERVER>"

接入 Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（Windows：%APPDATA%\Claude\claude_desktop_config.json），在 mcpServers 中加入：

{
  "mcpServers": {
    "stata": {
      "command": "<SERVER>",
      "args": []
    }
  }
}

保存后完全退出并重新打开 Claude Desktop。

如果 Stata 不在默认位置（macOS 默认搜索 /Applications/Stata、/Applications/StataNow 等），在配置里加环境变量：

"env": { "STATA_DIR": "/path/to/Stata", "STATA_EDITION": "mp" }

工具

输出位置

<项目文件夹>/stata_output/{do,logs,tables,figures}

• Claude Code（或 Desktop 的 Code 页签）：项目文件夹 = 会话所在文件夹。

• Desktop 普通聊天（没有文件夹）：默认 ~/Documents/Stata研究/；也可以直接告诉 Claude "项目放在某某目录"，它会调用 stata_set_workdir。

• 每条命令都会追加到 logs/history_<日期>.do，便于复现。

环境变量（可选）

推荐安装的 Stata 外部命令

ssc install reghdfe
ssc install ftools
ssc install estout
ssc install coefplot
ssc install csdid
ssc install drdid
ssc install did_imputation
ssc install eventstudyinteract
ssc install event_plot
ssc install boottest

stata_status 会列出哪些已安装。

已知事项

• 如果你的 profile.do 含有只在图形界面下可用的命令（如 window menu），无界面模式下它会中途停止；服务器启动后会补设 more off、type double、maxvar、linesize。

• Stata 内嵌 Python 不支持带空格的解释器路径；若仓库放在带空格的目录下，worker 会自动创建无空格的软链接（~/.cache/stata-econ-mcp/python）绕过。

• 安全约束（不执行 shell / !、不删除用户文件、安装外部命令前先询问）只通过给 Claude 的指令实现，代码层面没有强制拦截；它运行的是你本机的完整 Stata，请只在信任的客户端中使用。

许可证

MIT