
Stata MCP Server
io.github.aliveranme由 GitHub 帳號 aliveranme 發布v1.0.10更新於 Oct 24, 2026
通过 pystata 驱动真实 Stata 的 MCP 服务器:数据加载/清洗/建模/诊断/图形导出,75 个工具覆盖完整计量工作流。
概覽
透過 pystata 驅動真實 Stata,讓助理在同一個持續工作階段中完成資料載入、清理、建模、診斷與匯出。
- 可以做什麼
- 執行任意 Stata 指令、do 檔與說明查詢,支援背景任務與輸出翻頁
- 載入、匯入、儲存與重塑資料集,建立變數並宣告面板或時間序列結構
- 用 describe、codebook、summarize、tabulate 與相關分析探索資料
- 估計 OLS、logit/probit、卜瓦松、面板、工具變數、分位數與多層次模型,再執行 margins、檢定與預測
- 匯出圖形、Excel/CSV 檔案與論文式迴歸表,並把匯出檔案當成資源讀回
- 管理已安裝的外部套件,重設或快照工作階段
- 適用情境
- 適合用自然語言描述分析目標、讓助理完成多步驟計量分析而不必自己寫 Stata 指令的情境,也適合需要結果在多个步驟間保留在記憶體中的連續分析。
- 執行需求
- 本機安裝 Stata(StataNow 19 或 Stata 18+,MP/SE/BE 皆可)且包含 utilities/pystata,並以 STATA_HOME 指定安裝目錄;STATA_EDITION 選擇 mp、se 或 be。npx 套件需 Node.js 18+,另需 uv 或 Python 3.10+ 與 fastmcp。支援 Windows 與 macOS,Linux 未實測。搜尋與安裝外部套件需要連網。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Stata MCP Server,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
其他 MCP 客戶端
參照 儲存庫 中的啟動說明。
README
[Stata] [Python] [MCP] [75 tools] [MIT]
在 Claude Code 里用自然语言做 Stata 分析。你描述要什么,Agent 自己写命令、执行、 读结果、继续下一步 —— 加载数据、清洗、建模、诊断、导出,全在一个持久的 Stata 会话里完成,数据不用反复载入。
一句话,跑完整个分析
你: 加载 auto.dta,用 weight 和 mpg 回归 price,并检查异方差
Agent 自动完成(无需你写任何 Stata 命令):
数据从第一步起就留在内存里,后面每一步都接着用 —— 这正是 stata_run("regress …")
之外还值得有一个 MCP Server 的原因。
这是什么
两部分组成,一起装进 Claude Code:
- 执行层(MCP Server) —— 经
pystata直接调用 Stata 的运行时,把 75 个工具 暴露给 Agent。stata_run执行任意命令、stata_help查任意命令的官方语法,二者 合起来即「全量内置命令支持」;其余专用工具(回归 / 面板 / IV / 生成变量 / 数据 清洗 / 后估计 / 文件资源 / 后台任务 …)是给高频命令加结构化参数与校验的便利层。 - 知识层(Skill) —— 一份 Stata 编程指南:语法要点、分析模板、常见陷阱、命令 地图与常用外置包。Agent 据此知道该用什么命令,而不是靠猜。
为什么是 pystata,而不是 subprocess
pystata 通过 ctypes 在进程内加载 Stata 运行时,而非每条命令起一个子进程:
- 真会话持久 —— Stata 在 MCP Server 启动时初始化一次,数据集、估计结果、局部 宏在所有工具调用之间保持。多步分析(加载 → 清洗 → 回归 → 诊断)就是自然的对话。
- 低延迟 —— 无进程启动开销,单条命令约 12ms。
- 输出可控 —— 直接读 Stata 输出缓冲;大输出自动分页(
stata_more翻页), 硬上限 120K 字符防止撑爆 MCP 通道;长命令有 60s 超时看门狗(可显式调大)。
架构
快速开始
前置条件
- Stata:StataNow 19 或 Stata 18+(MP / SE / BE 均可)——需含
utilities/pystata - Python 3.10+(推荐 3.12+)
- Claude Code 最新版
- 操作系统:Windows 或 macOS(见下方「兼容性」)
一键安装
装在非标准位置(如外置卷
/Volumes/xxx/Applications/StataNow)时自动检测会失败 —— 先export STATA_HOME=/你的/Stata路径再跑setup.py即可。
setup.py 会:检测 Stata 安装(常见路径 + STATA_HOME 环境变量,跨平台)→
创建虚拟环境并安装 fastmcp → 生成 .mcp.json(保留你已有的其他 MCP Server 配置)
→ 验证 Server 可启动。
手动安装(自动检测失败时)
通过 npm 安装(无需 clone 仓库)
若你已有 Node.js ≥ 18 与 uv(无 uv 时需 Python 3.10+ 且已装 fastmcp>=3.2.0),可直接使用已发布的
npm 包 @aliveranme/stata-mcp:
Claude Code .mcp.json 配置:
npx @aliveranme/stata-mcp与npx stata-mcp-server(bin 名)等价,二者都触发同一个启动器。
连接并验证
重启 Claude Code(或 /reload-plugins),.mcp.json 里的 stata Server 会自动连接。
然后在对话里直接说:
帮我加载 auto.dta 并做描述统计
Agent 会自动走 stata_use_dataset → stata_describe → stata_summarize。
各 Agent 安装教程
除 Claude Code 外,本 MCP 可接入所有支持 MCP 的客户端/Agent。逐平台教程见
docs/agent-setup/:
插件 / 扩展市场分发(Claude Code 插件、Cursor 扩展、Claude Desktop
.mcpb)的可行性 评估见 plugin-distribution.md。
MCP 工具(75 个)
能力边界不在工具数量上:
stata_run+stata_help已覆盖全部内置命令。下面的 专用工具是给高频命令加结构化参数与校验的便利层。
各工具的参数与说明
数据管理 — stata_use_dataset 加载 .dta(可只载入子集);stata_import 覆盖官方
import 命令族,按扩展名推断格式;stata_save_dataset 保存;stata_set_cwd 改工作目录;
stata_generate / stata_egen 创建变量(支持官方 [type] 存储类型与 [if] [in]);
stata_xtset 声明面板 / 时序结构 —— 它是 stata_xtreg 的前提。
数据探索 — stata_summarize / stata_codebook / stata_list / stata_tabulate
均支持 condition;stata_correlate 可选 pairwise 走 pwcorr;stata_display
算表达式 / 看返回值。
估计 — stata_regress(OLS)、stata_logistic、stata_probit(可选
marginal_effects)、stata_poisson(可选 irr)、stata_ttest(可按组)、
stata_xtreg(effects = fe/re/be/mle/pa,需先 xtset)、stata_ivregress
(2sls/liml/gmm)。扩展族:stata_logit(报告原始系数,OR 用 logistic)、
stata_mlogit(多分类,baseoutcome 定基准)、stata_nbreg(负二项)、
stata_qreg(分位,quantile 默认 0.5)、stata_mixed(多水平,random="|| id:")。
数据清洗 — stata_replace 覆盖变量值、stata_drop/stata_keep 删/留变量或观测
(两种形态二选一)、stata_rename 重命名(单个或批量)、stata_recode 重编码
(values="(1=0) (2/4=1)" 官方规则组)、stata_destring 字符串转数值(必须
replace=True 或 generate())。
后估计(须先跑估计命令)— stata_margins(dydx / at)、stata_test
(Wald 检验)、stata_predict(预测值 / 残差,会创建变量)、stata_lincom /
stata_nlcom(线性 / 非线性组合检验)、stata_hausman(模型比较,需先
stata_estimates action="store" 存两个模型)。
图形 / 导出 — stata_graph 把 graph 与 export 原子执行,以文件是否真被写入判定
成败。导出选项按格式自动适配官方边界:尺寸单位(位图与 svg 用像素、pdf 用英寸、
eps/ps/emf 不支持)、quality(仅 jpg)、mag(仅 pdf/eps/ps)、fontface
(仅矢量格式)—— 不适用的选项被丢弃并在返回信息中说明,而非让 Stata 静默失败。
stata_scheme 列出 / 查询 / 设置主题(不传 scheme 时不会改动你当前的主题)。
stata_export_excel 导数据为 .xlsx(支持 sheet_mode / cell / firstrow /
if-in 筛选);stata_export_delimited 导 CSV / TSV / 自定义分隔符。
回归表用 stata_etable(官方 etable,Stata 17+,无第三方依赖):
estimates="m1 m2 m3" 并排多模型,直出 .docx / .xlsx / .pdf / .tex / .html / .md,
并以文件是否真被写入判定成败 —— etable 会先把表打印出来再报导出错误,只看输出
很容易把失败当成功。
包管理与帮助 — stata_help("命令") 查任意内置 / 已装外置命令的官方语法;
stata_find_package 走 net search 联网找包;stata_install_package 装(ssc 或 URL);
stata_uninstall_package 卸载(ado uninstall,纯本地);stata_describe_package
查包详情(默认本地 ado describe,source="ssc" 走联网 ssc describe 供装前了解);
stata_list_packages 列已装。
会话 — stata_more 翻上一条命令的完整输出;stata_status 一次给出数据集、工作目录、
frame、面板/时序设定、已存与活跃的估计结果、内存 —— 即 Agent 调 xtreg /
margins / predict 前需要确认的全部前提;stata_ping 心跳。stata_clear 按 scope
重置会话(data/estimates/graphs/panels/all);stata_snapshot 用 Stata 原生快照在数据
阶段间快速回退(save/list/restore/erase)。
文件资源回传 — 导出工具(stata_graph / stata_export_* / stata_etable /
stata_save_dataset / stata_run save_output=)成功后把文件登记为 MCP 资源。远程
客户端经 resources/read 读 stata-file:///<路径> 取回图表 / Excel / CSV / dta 的
二进制,或 stata_read_file 取 base64 / 元信息;stata_list_resources 列出全部登记
文件,stata_register_file 登记已有的磁盘文件。安全边界:只读登记过的文件。
长任务控制 — stata_background 把耗时长命令放到后台(立即返回任务号,单块超时
上限 3600s,运行期间其他调用会等待共享的 _stata_lock);stata_task_status 查进度、
stata_task_cancel 显式取消、stata_task_result 取结果、stata_task_list 列全部。
stata_read_log 读本服务器运行日志排查问题。
Stata 知识 Skill
.claude/skills/stata/SKILL.md 是 Agent 的 Stata 编程参考:
兼容性
pystata是 Stata 官方的 Python 集成,随 Stata 一同分发,Windows / macOS / Linux 均提供。本项目在 Windows 与 macOS(StataNow 19.5 MP)上均实测可用。
配置
环境变量
开发 / 调试
项目结构
许可证
MIT License
來源:README.md,提交 20180ba
工具
0版本歷史
1- v1.0.10最新Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分