本文基于官方文档与项目说明整理编写，所有参考资料已附在文末，读者可查阅原文。本文将提供完整配置路径，适用于零基础用户。

一、什么是 Stata MCP

Stata MCP 是一个基于 Model Context Protocol（MCP） 的服务，用于连接 AI 与 Stata。

它的工作方式是：

• • AI 生成 Stata 命令
• • MCP 接收命令并调用 Stata
• • Stata 执行后返回结果

这使 AI 可以直接参与数据分析流程。

二、前置知识

在实际使用中，有三个组件：

AI（Codex / Claude Code）↓MCP Server（stata-mcp）↓Stata

你真正需要做的只有两件事：

1. 1. 启动 MCP
2. 2. 让 AI “知道” MCP 是一个可以调用的工具

三、环境准备

必备软件

• • Stata（建议 17+）
• • Python ≥ 3.11
• • Node.js（用于 Codex CLI）
• • MCP Server（stata-mcp）

四、安装 Stata MCP（官方方式）

1. 安装

pip install aigroup-stata-mcp

或：

uvx aigroup-stata-mcp

2. 创建配置文件

在你的项目目录创建：

config.toml

内容：

working_directory = "/你的工作目录"stata_path = "/你的Stata路径"

3. 启动 MCP

stata-mcp

此时 MCP 已运行，但 AI 还无法使用它。

五、关键步骤：让 AI 调用 Stata MCP

这一部分是新手最容易卡住的地方。

重点：你必须在 AI 工具中注册 MCP

六、方案一：Claude Code

Claude Code 对 MCP 是“原生支持”的。

操作步骤

在终端输入：

claude mcp add stata-mcp \--env STATA_MCP_CWD=$(pwd) \--scope project \-- uvx stata-mcp

这一步做了什么？

它完成了三件事：

1. 1. 注册一个工具（stata-mcp）
2. 2. 指定运行方式（uvx stata-mcp）
3. 3. 告诉 Claude：这个工具可以被调用

使用方式

直接输入：

用 auto 数据做回归：price 对 mpg 和 weight

Claude 会：

• • 自动调用 MCP
• • 自动执行 Stata
• • 返回结果

七、方案二：Codex

这里重点讲清楚，因为很多教程都写得不完整。

1. 安装 Codex CLI

npm install -g @openai/codex

安装后运行：

codex

2. Codex 的“工具注册”在哪里做？

关键点：

👉 在项目目录创建配置文件

文件名：

codex.json

3. 配置 MCP 工具

在 codex.json 中写入：

{  "tools": [    {      "name": "stata",      "command": "uvx",      "args": ["stata-mcp"],      "env": {        "STATA_MCP_CWD": "./"      }    }  ]}

其中：

4. 启动 Codex（必须在该目录）

codex

注意：

👉 必须在包含 codex.json 的目录启动

5. 验证是否成功

在 Codex 中输入：

列出当前可用MCP工具

如果看到：

stata

说明注册成功。

6. 实际调用 Stata

输入：

用 Stata 的 auto 数据做回归：price 对 mpg 和 weight

Codex 会自动执行：

sysuse autoreg price mpg weight

返回内容包括：

• • 回归结果表
• • 系数
• • 显著性

9. 进一步操作

继续输入：

解释回归结果

或：

加入更多控制变量

八、完整流程总结（Codex）

1. 安装 MCP2. 写 config.toml3. 写 codex.json4. 在该目录启动 codex5. 输入自然语言

九、常见错误（重点）

1. 工具没有生效

原因：

• • 没在正确目录启动 codex
• • codex.json 写错

2. Stata 无法启动

检查：

• • 路径是否正确
• • 是否有权限

3. 没有返回结果

可能原因：

• • MCP 未启动
• • uvx 未安装

十、基础实战示例

输入：

用 auto 数据做回归：price 对 mpg 和 weight

执行：

sysuse autoreg price mpg weight

后续：

写一段论文结果解释（英文）

十一、总结

Stata MCP 的关键不在于命令本身，而在于：

• • 正确启动 MCP
• • 正确注册工具

一旦配置完成，后续使用方式与普通对话一致。

参考资料（官方来源）

1. 1. Stata MCP 项目（PyPI）https://pypi.org/project/aigroup-stata-mcp/
2. 2. MCP 协议官方说明https://modelcontextprotocol.io/
3. 3. MCP Stata 实现说明https://pypi.org/project/mcp-stata/
4. 4. Claude Code MCP 使用说明https://mcpcow.com/ja/service/stata-1/