跳转至

在 OpenClaw 中使用 🦞

由于 OpenClaw 原生不支持 MCP 工具协议,Stata-MCP 提供了独立的 CLI 工具命令,OpenClaw 可以通过终端工具调用使用。

安装指引(OpenClaw)

复制下面的信息发送给你的 OpenClaw:

Install Stata-MCP Skills from https://docs.statamcp.com/skills/openclaw

如果你是 OpenClaw,请直接访问 Stata-MCP Skill for OpenClaw

手动安装

# 使用 uvx 直接运行(推荐)
uvx stata-mcp tool --help

# 或安装后使用
uv pip install stata-mcp
stata-mcp tool --help

可用命令

ado-install - 安装 Stata 包

从 SSC、GitHub 或网络安装 ado 包。

# 从 SSC 安装(默认)
stata-mcp tool ado-install outreg2

# 从 GitHub 安装
stata-mcp tool ado-install SepineTam/TexIV --source github

# 从网络安装
stata-mcp tool ado-install custompkg --source net --package-source-from "https://example.com/stata/"

# 不替换已安装的包(可用于检查安装状态)
stata-mcp tool ado-install estout --is-replace false

参数

参数 说明 默认值
package_name 包名(必填) -
--source 安装源:ssc / net / github ssc
--package-source-from net 安装的源 URL -
--is-replace 替换已存在的包文件 true

do - 执行 do 文件

执行 Stata do 文件并获取日志。

# 执行 do 文件
stata-mcp tool do /path/to/analysis.do

# 指定日志文件名
stata-mcp tool do /path/to/analysis.do --log-file-name my_results

# 不读取日志内容
stata-mcp tool do /path/to/analysis.do --is-read-log false

# 禁用 SMCL 格式日志
stata-mcp tool do /path/to/analysis.do --enable-smcl false

参数

参数 说明 默认值
dofile_path do 文件路径(必填) -
--log-file-name 日志文件名(不含扩展名) 自动生成
--is-read-log 执行后读取日志内容 true
--is-replace-log 替换已存在的日志文件 true
--enable-smcl 生成 SMCL 格式日志 true

help - 获取 Stata 命令帮助

仅支持 macOS 和 Linux

# 获取命令帮助
stata-mcp tool help regress

# 获取面板数据命令帮助
stata-mcp tool help xtreg
stata-mcp tool help xtset

参数

参数 说明 默认值
stata_command Stata 命令名(必填) -
--is-read-log 读取输出内容 true
--enable-smcl 生成 SMCL 格式输出 true

data-info - 获取数据信息

分析数据文件并返回统计摘要。

# 分析数据文件
stata-mcp tool data-info /path/to/data.dta

# 指定变量子集
stata-mcp tool data-info /path/to/data.csv --vars-list gdp inflation unemployment

# 指定编码
stata-mcp tool data-info /path/to/legacy.csv --encoding latin1

支持格式: - Stata:.dta - CSV/文本:.csv.tsv.psv - Excel:.xlsx.xls - SPSS:.sav.zsav

参数

参数 说明 默认值
data_path 数据文件路径(必填) -
--encoding 文本编码 utf-8
--vars-list 要分析的变量名列表 全部变量

read-log - 读取日志文件

读取 Stata 日志文件(.log 或 .smcl)。

# 读取日志(核心内容)
stata-mcp tool read-log /path/to/output.log

# 读取完整日志
stata-mcp tool read-log /path/to/output.log --output-format full

# 读取为结构化格式
stata-mcp tool read-log /path/to/output.log --output-format dict

# 指定编码
stata-mcp tool read-log /path/to/output.log --encoding utf-8

参数

参数 说明 默认值
file_path 日志文件路径(必填) -
--encoding 文件编码 utf-8
--output-format 输出格式:full / core / dict core

输出格式说明: - full:原始日志内容 - core:去除框架行(日志头尾、log 命令等)的干净内容 - dict:结构化的命令-结果对


典型工作流程

# 1. 查看数据结构
stata-mcp tool data-info /project/data/raw/survey.dta

# 2. 获取命令帮助
stata-mcp tool help regress

# 3. 安装所需包
stata-mcp tool ado-install outreg2

# 4. 执行分析脚本
stata-mcp tool do /project/stata-mcp-dofile/analysis.do

# 5. 查看执行日志
stata-mcp tool read-log /project/stata-mcp-log/analysis.log --output-format core

注意事项

  1. Stata 许可证:需要有效的 Stata 安装和许可证
  2. 路径格式:建议使用绝对路径
  3. help 命令:仅支持 macOS 和 Linux
  4. 日志位置:默认在 <cwd>/stata-mcp-folder/stata-mcp-log/