1. 为什么 Stata 用户需要 MCP 这层“翻译官”如果你平时用 Stata 做实证研究大概率经历过这种循环在 Stata 自带编辑器里敲reg、xtreg、reghdfe报错信息只有一行红字得自己翻 help 文件猜哪里写错了想换个稳健标准误的写法又得去搜半天语法。Stata 本身是个封闭的统计环境它不认现代编辑器那套语言服务更不会主动把会话状态暴露给外部程序。MCPModel Context Protocol解决的就是这个“暴露”问题。你可以把它理解成一个标准插座Stata 这边通过 Stata MCP 扩展把“执行命令、读取日志、返回结果”包装成 MCP 工具IDE 那边的 AI Agent比如 Cline、Cursor 的 Agent 模式通过这个插座调用工具。Agent 不再只是“猜”你的数据长什么样而是能真的把summarize跑一遍拿到真实的观测值数量、均值、缺失情况再决定下一步写什么代码。这套链路适合谁适合已经在用 VS Code 或 Cursor 写.do文件、但苦于 AI 只能给通用建议的科研用户。配置完成后你可以在对话里说“帮我检查这份数据里 price 和 mpg 的关系先做描述统计再跑回归”Agent 会自己调用 Stata 执行、读结果、再继续。整个过程不需要你手动复制粘贴输出。需要提前说明的是Stata MCP 扩展负责的是“本地 Stata 会话与 IDE 之间的桥接”而大模型本身的调用通道需要单独配置。这篇教程用 TaoToken 作为统一的 API 入口把模型 Key 和 MCP 配置分开管理避免每个客户端各填一套 Key 的混乱。2. 前置准备Stata MCP 扩展与 TaoToken 统一 Key2.1 环境检查清单动手之前先确认三件事。第一Stata 版本要在 17 及以上MP、SE、BE 都可以但路径要记清楚。第二Python 版本要 3.11 以上因为 Stata MCP 依赖的 UV 包管理器对 Python 版本有要求。第三IDE 选 VS Code 或 Cursor两者都支持 MCP 客户端配置Cursor 的 Agent 模式对工具调用更顺手。检查 Python 的命令很简单python --version # 或 python3 --version如果低于 3.11去 Python 官网下载安装包Windows 安装时记得勾选 “Add Python to PATH”。macOS 可以用 Homebrewbrew install python3.11Stata 路径的确认方式Windows 在命令提示符里跑C:\Program Files\Stata17\StataMP-64.exe --versionmacOS 在终端里跑/Applications/Stata/StataMP.app/Contents/MacOS/stata-mp --version能打印出版本号就说明路径没问题后面配置stataPath时直接复制这个路径。2.2 安装 Stata MCP 扩展扩展的安装有两种方式。插件市场搜索 “Stata MCP” 是最直接的但有时候市场索引延迟搜不到。更稳的方式是去 GitHub Releases 页面下载.vsix文件然后用终端安装。VS Code 用户code --install-extension /path/to/stata-mcp-x.x.x.vsixCursor 用户cursor --install-extension /path/to/stata-mcp-x.x.x.vsix如果提示cursor: command not found在 Cursor 里按CmdShiftPWindows 是CtrlShiftP输入 “Shell Command: Install ‘cursor’ command in PATH”执行后再重开终端。安装完成后打开输出面板CtrlShiftU或CmdShiftU下拉菜单选 “Stata-MCP”能看到扩展启动日志就说明装好了。2.3 TaoToken 统一 Key 的获取与定位TaoToken 在这里的角色是“模型调用的统一入口”。你不需要在每个客户端里分别填 OpenAI、Anthropic 的 Key而是拿一个 TaoToken 的 Key通过它的 API 通道去调用不同模型。获取 Key 的入口在控制台登录后进入 API Keys 页面创建一个新 Key。创建时建议按用途命名比如stata-mcp-agent方便后面排查是哪个客户端在调用。拿到 Key 之后记住两个地址。API 基础地址是https://taotoken.net/api模型对话和 Coding Plan 的入口分别在https://taotoken.net/api/chat https://taotoken.net/api/coding-plan这两个地址后面配置客户端时会用到。注意 API 地址不带任何查询参数Key 通过请求头传递。3. 可复制配置settings.json 与 config.toml 骨架3.1 VS Code / Cursor 的 settings.jsonStata MCP 扩展的配置写在 IDE 的settings.json里。打开方式Ctrl,或Cmd,打开设置面板右上角有个“打开设置(JSON)”图标点进去就能编辑。最小可用配置只需要两行前提是扩展能自动检测到 Stata{ stata-vscode.autoStartServer: true, stata-vscode.mcpServerPort: 4000 }如果自动检测失败补上路径和版本{ stata-vscode.stataPath: C:\\Program Files\\Stata17\\StataMP-64.exe, stata-vscode.stataEdition: MP, stata-vscode.autoStartServer: true, stata-vscode.mcpServerHost: localhost, stata-vscode.mcpServerPort: 4000, stata-vscode.runFileTimeout: 600, stata-vscode.debugMode: false }macOS 的路径写法不同注意指向Contents/MacOS/下的可执行文件{ stata-vscode.stataPath: /Applications/Stata/StataMP.app/Contents/MacOS/stata-mp, stata-vscode.stataEdition: MP }这里有个容易踩的坑Windows 路径里的反斜杠要写成双反斜杠\\或者直接用正斜杠/。单反斜杠在 JSON 里是转义字符会导致路径解析失败。3.2 Cline 的 cline_mcp_settings.jsonCline 是 VS Code 上的 AI 编程扩展它的 MCP 配置独立于 IDE 设置。配置文件位置按系统区分Windows%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.jsonmacOS~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.jsonLinux~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json文件内容加上 Stata MCP 的 SSE 端点{ mcpServers: { stata-mcp: { url: http://localhost:4000/mcp, transport: sse } } }Cline 本身调用大模型时在它的设置界面里把 API Provider 选成 OpenAI CompatibleBase URL 填https://taotoken.net/apiAPI Key 填 TaoToken 控制台创建的那个 Key。这样 Cline 的对话能力和 Stata MCP 的工具调用就走同一条通道。3.3 config.toml 骨架Coding Plan 场景如果你用的是支持config.toml的客户端比如某些 CLI 工具或 Coding Plan 接入方式骨架大致如下[model] provider openai-compatible base_url https://taotoken.net/api api_key 你的TaoToken Key model_name claude-sonnet-4-20250514 [mcp_servers.stata] url http://localhost:4000/mcp transport sse enabled truemodel_name按你实际要用的模型填TaoToken 的模型对话入口支持多种模型切换。base_url保持https://taotoken.net/api不变不要在后面拼/v1之类的后缀通道已经处理好了。4. 验证请求从 .do 文件到 Agent 读写会话4.1 先确认 Stata MCP 本身能跑新建一个test.do文件写入以下内容clear all set more off sysuse auto, clear describe summarize price mpg weight regress price mpg weight display Stata MCP 通道正常选中全部代码按CtrlShiftEnterWindows或CmdShiftEntermacOS运行选中部分。打开输出面板选 “Stata-MCP”应该能看到describe的变量列表、summarize的统计表、regress的系数表最后一行打印出“Stata MCP 通道正常”。这一步验证的是扩展本身和 Stata 可执行文件的连通性。如果这里就报 “Stata not found”回到第 3 节检查stataPath。4.2 验证 Agent 能调用 MCP 工具打开 Cline 或 Cursor 的 Agent 对话窗口输入请调用 stata-mcp 工具在当前 Stata 会话里执行 sysuse auto, clear然后跑 summarize price把结果告诉我。Agent 应该会发起一次工具调用你会在对话里看到它请求执行 Stata 命令然后返回真实的统计输出。如果 Agent 只是“假装”回答而没有工具调用记录说明 MCP 配置没被识别检查cline_mcp_settings.json的路径和 JSON 格式。4.3 验证模型通道在同一个对话窗口里问一个需要模型推理的问题根据刚才 summarize 的结果price 的均值和标准差分别是多少如果我要做 price 对 mpg 的回归样本量大概是多少Agent 需要同时用到 MCP 返回的真实数据和模型本身的推理能力。如果它能准确引用summarize输出里的数字说明 TaoToken 的模型通道和 Stata MCP 的工具通道都通了。这一步的典型成功标志是Agent 的回答里出现了sysuse auto数据集的真实统计量比如 price 均值约 6165而不是编造的数字。5. 本篇常见错排查5.1 端口 4000 被占用症状是输出面板显示 “Failed to start MCP server” 或端口冲突。先查占用# Windows netstat -ano | findstr :4000 # macOS/Linux lsof -i :4000找到进程 ID 后结束它或者直接换端口{ stata-vscode.mcpServerPort: 4001, stata-vscode.forcePort: true }换端口后记得同步更新 Cline 配置里的url。5.2 UV 包管理器安装失败Stata MCP 依赖 UV 来管理 Python 环境。如果扩展日志里出现 UV 相关错误手动装一次# macOS/Linux curl -LsSf https://astral.sh/uv/install.sh | sh # Windows PowerShell 管理员模式 powershell -ExecutionPolicy ByPass -c irm https://astral.sh/uv/install.ps1 | iex装完跑uv --version确认然后重启 IDE。5.3 Agent 看不到 stata-mcp 工具如果 Cline 的对话里 Agent 说“我没有 stata-mcp 这个工具”按顺序检查cline_mcp_settings.json的路径是否对应你实际用的 IDEVS Code 和 Cursor 的路径不同JSON 里transport是否写成sseStata MCP 扩展的输出面板是否显示服务器已在 4000 端口监听。三者缺一不可。5.4 模型返回 401 或鉴权失败TaoToken 的 Key 填错、过期或者 Base URL 多写了后缀都会导致 401。确认base_url是https://taotoken.net/apiKey 从控制台重新复制一次注意不要带多余空格。如果用的是 Coding Plan 通道检查config.toml里的provider是否写成了openai-compatible。6. 把 Key 和 MCP 分开管理后续换模型不折腾这套配置跑通之后你会发现一个好处Stata MCP 的配置和模型通道的配置是解耦的。settings.json里只管 Stata 路径和端口cline_mcp_settings.json只管 MCP 端点模型 Key 和 Base URL 在客户端的大模型设置里单独填。以后想换模型只改模型那一处Stata 这边的配置不用动。如果你主要做长期编码和 Agent 任务建议走 Coding Plan 通道入口在https://taotoken.net/api/coding-plan适合需要连续多轮工具调用的场景。如果只是偶尔验证模型输出用模型对话入口https://taotoken.net/api/chat就够了。Key 的统一管理在控制台的 API Keys 页面接入文档在https://taotoken.net/api/doc可以查到各客户端的详细填写位置。实际用下来Stata MCP 最省心的地方是 Agent 能直接读describe和summarize的真实输出不用你手动贴数据概况。配置阶段花十分钟把路径和端口理顺后面写论文的回归流程会顺畅很多。
1. 为什么 Stata 用户需要 MCP 这层“翻译官”如果你平时用 Stata 做实证研究大概率经历过这种循环在 Stata 自带编辑器里敲reg、xtreg、reghdfe报错信息只有一行红字得自己翻 help 文件猜哪里写错了想换个稳健标准误的写法又得去搜半天语法。Stata 本身是个封闭的统计环境它不认现代编辑器那套语言服务更不会主动把会话状态暴露给外部程序。MCPModel Context Protocol解决的就是这个“暴露”问题。你可以把它理解成一个标准插座Stata 这边通过 Stata MCP 扩展把“执行命令、读取日志、返回结果”包装成 MCP 工具IDE 那边的 AI Agent比如 Cline、Cursor 的 Agent 模式通过这个插座调用工具。Agent 不再只是“猜”你的数据长什么样而是能真的把summarize跑一遍拿到真实的观测值数量、均值、缺失情况再决定下一步写什么代码。这套链路适合谁适合已经在用 VS Code 或 Cursor 写.do文件、但苦于 AI 只能给通用建议的科研用户。配置完成后你可以在对话里说“帮我检查这份数据里 price 和 mpg 的关系先做描述统计再跑回归”Agent 会自己调用 Stata 执行、读结果、再继续。整个过程不需要你手动复制粘贴输出。需要提前说明的是Stata MCP 扩展负责的是“本地 Stata 会话与 IDE 之间的桥接”而大模型本身的调用通道需要单独配置。这篇教程用 TaoToken 作为统一的 API 入口把模型 Key 和 MCP 配置分开管理避免每个客户端各填一套 Key 的混乱。2. 前置准备Stata MCP 扩展与 TaoToken 统一 Key2.1 环境检查清单动手之前先确认三件事。第一Stata 版本要在 17 及以上MP、SE、BE 都可以但路径要记清楚。第二Python 版本要 3.11 以上因为 Stata MCP 依赖的 UV 包管理器对 Python 版本有要求。第三IDE 选 VS Code 或 Cursor两者都支持 MCP 客户端配置Cursor 的 Agent 模式对工具调用更顺手。检查 Python 的命令很简单python --version # 或 python3 --version如果低于 3.11去 Python 官网下载安装包Windows 安装时记得勾选 “Add Python to PATH”。macOS 可以用 Homebrewbrew install python3.11Stata 路径的确认方式Windows 在命令提示符里跑C:\Program Files\Stata17\StataMP-64.exe --versionmacOS 在终端里跑/Applications/Stata/StataMP.app/Contents/MacOS/stata-mp --version能打印出版本号就说明路径没问题后面配置stataPath时直接复制这个路径。2.2 安装 Stata MCP 扩展扩展的安装有两种方式。插件市场搜索 “Stata MCP” 是最直接的但有时候市场索引延迟搜不到。更稳的方式是去 GitHub Releases 页面下载.vsix文件然后用终端安装。VS Code 用户code --install-extension /path/to/stata-mcp-x.x.x.vsixCursor 用户cursor --install-extension /path/to/stata-mcp-x.x.x.vsix如果提示cursor: command not found在 Cursor 里按CmdShiftPWindows 是CtrlShiftP输入 “Shell Command: Install ‘cursor’ command in PATH”执行后再重开终端。安装完成后打开输出面板CtrlShiftU或CmdShiftU下拉菜单选 “Stata-MCP”能看到扩展启动日志就说明装好了。2.3 TaoToken 统一 Key 的获取与定位TaoToken 在这里的角色是“模型调用的统一入口”。你不需要在每个客户端里分别填 OpenAI、Anthropic 的 Key而是拿一个 TaoToken 的 Key通过它的 API 通道去调用不同模型。获取 Key 的入口在控制台登录后进入 API Keys 页面创建一个新 Key。创建时建议按用途命名比如stata-mcp-agent方便后面排查是哪个客户端在调用。拿到 Key 之后记住两个地址。API 基础地址是https://taotoken.net/api模型对话和 Coding Plan 的入口分别在https://taotoken.net/api/chat https://taotoken.net/api/coding-plan这两个地址后面配置客户端时会用到。注意 API 地址不带任何查询参数Key 通过请求头传递。3. 可复制配置settings.json 与 config.toml 骨架3.1 VS Code / Cursor 的 settings.jsonStata MCP 扩展的配置写在 IDE 的settings.json里。打开方式Ctrl,或Cmd,打开设置面板右上角有个“打开设置(JSON)”图标点进去就能编辑。最小可用配置只需要两行前提是扩展能自动检测到 Stata{ stata-vscode.autoStartServer: true, stata-vscode.mcpServerPort: 4000 }如果自动检测失败补上路径和版本{ stata-vscode.stataPath: C:\\Program Files\\Stata17\\StataMP-64.exe, stata-vscode.stataEdition: MP, stata-vscode.autoStartServer: true, stata-vscode.mcpServerHost: localhost, stata-vscode.mcpServerPort: 4000, stata-vscode.runFileTimeout: 600, stata-vscode.debugMode: false }macOS 的路径写法不同注意指向Contents/MacOS/下的可执行文件{ stata-vscode.stataPath: /Applications/Stata/StataMP.app/Contents/MacOS/stata-mp, stata-vscode.stataEdition: MP }这里有个容易踩的坑Windows 路径里的反斜杠要写成双反斜杠\\或者直接用正斜杠/。单反斜杠在 JSON 里是转义字符会导致路径解析失败。3.2 Cline 的 cline_mcp_settings.jsonCline 是 VS Code 上的 AI 编程扩展它的 MCP 配置独立于 IDE 设置。配置文件位置按系统区分Windows%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.jsonmacOS~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.jsonLinux~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json文件内容加上 Stata MCP 的 SSE 端点{ mcpServers: { stata-mcp: { url: http://localhost:4000/mcp, transport: sse } } }Cline 本身调用大模型时在它的设置界面里把 API Provider 选成 OpenAI CompatibleBase URL 填https://taotoken.net/apiAPI Key 填 TaoToken 控制台创建的那个 Key。这样 Cline 的对话能力和 Stata MCP 的工具调用就走同一条通道。3.3 config.toml 骨架Coding Plan 场景如果你用的是支持config.toml的客户端比如某些 CLI 工具或 Coding Plan 接入方式骨架大致如下[model] provider openai-compatible base_url https://taotoken.net/api api_key 你的TaoToken Key model_name claude-sonnet-4-20250514 [mcp_servers.stata] url http://localhost:4000/mcp transport sse enabled truemodel_name按你实际要用的模型填TaoToken 的模型对话入口支持多种模型切换。base_url保持https://taotoken.net/api不变不要在后面拼/v1之类的后缀通道已经处理好了。4. 验证请求从 .do 文件到 Agent 读写会话4.1 先确认 Stata MCP 本身能跑新建一个test.do文件写入以下内容clear all set more off sysuse auto, clear describe summarize price mpg weight regress price mpg weight display Stata MCP 通道正常选中全部代码按CtrlShiftEnterWindows或CmdShiftEntermacOS运行选中部分。打开输出面板选 “Stata-MCP”应该能看到describe的变量列表、summarize的统计表、regress的系数表最后一行打印出“Stata MCP 通道正常”。这一步验证的是扩展本身和 Stata 可执行文件的连通性。如果这里就报 “Stata not found”回到第 3 节检查stataPath。4.2 验证 Agent 能调用 MCP 工具打开 Cline 或 Cursor 的 Agent 对话窗口输入请调用 stata-mcp 工具在当前 Stata 会话里执行 sysuse auto, clear然后跑 summarize price把结果告诉我。Agent 应该会发起一次工具调用你会在对话里看到它请求执行 Stata 命令然后返回真实的统计输出。如果 Agent 只是“假装”回答而没有工具调用记录说明 MCP 配置没被识别检查cline_mcp_settings.json的路径和 JSON 格式。4.3 验证模型通道在同一个对话窗口里问一个需要模型推理的问题根据刚才 summarize 的结果price 的均值和标准差分别是多少如果我要做 price 对 mpg 的回归样本量大概是多少Agent 需要同时用到 MCP 返回的真实数据和模型本身的推理能力。如果它能准确引用summarize输出里的数字说明 TaoToken 的模型通道和 Stata MCP 的工具通道都通了。这一步的典型成功标志是Agent 的回答里出现了sysuse auto数据集的真实统计量比如 price 均值约 6165而不是编造的数字。5. 本篇常见错排查5.1 端口 4000 被占用症状是输出面板显示 “Failed to start MCP server” 或端口冲突。先查占用# Windows netstat -ano | findstr :4000 # macOS/Linux lsof -i :4000找到进程 ID 后结束它或者直接换端口{ stata-vscode.mcpServerPort: 4001, stata-vscode.forcePort: true }换端口后记得同步更新 Cline 配置里的url。5.2 UV 包管理器安装失败Stata MCP 依赖 UV 来管理 Python 环境。如果扩展日志里出现 UV 相关错误手动装一次# macOS/Linux curl -LsSf https://astral.sh/uv/install.sh | sh # Windows PowerShell 管理员模式 powershell -ExecutionPolicy ByPass -c irm https://astral.sh/uv/install.ps1 | iex装完跑uv --version确认然后重启 IDE。5.3 Agent 看不到 stata-mcp 工具如果 Cline 的对话里 Agent 说“我没有 stata-mcp 这个工具”按顺序检查cline_mcp_settings.json的路径是否对应你实际用的 IDEVS Code 和 Cursor 的路径不同JSON 里transport是否写成sseStata MCP 扩展的输出面板是否显示服务器已在 4000 端口监听。三者缺一不可。5.4 模型返回 401 或鉴权失败TaoToken 的 Key 填错、过期或者 Base URL 多写了后缀都会导致 401。确认base_url是https://taotoken.net/apiKey 从控制台重新复制一次注意不要带多余空格。如果用的是 Coding Plan 通道检查config.toml里的provider是否写成了openai-compatible。6. 把 Key 和 MCP 分开管理后续换模型不折腾这套配置跑通之后你会发现一个好处Stata MCP 的配置和模型通道的配置是解耦的。settings.json里只管 Stata 路径和端口cline_mcp_settings.json只管 MCP 端点模型 Key 和 Base URL 在客户端的大模型设置里单独填。以后想换模型只改模型那一处Stata 这边的配置不用动。如果你主要做长期编码和 Agent 任务建议走 Coding Plan 通道入口在https://taotoken.net/api/coding-plan适合需要连续多轮工具调用的场景。如果只是偶尔验证模型输出用模型对话入口https://taotoken.net/api/chat就够了。Key 的统一管理在控制台的 API Keys 页面接入文档在https://taotoken.net/api/doc可以查到各客户端的详细填写位置。实际用下来Stata MCP 最省心的地方是 Agent 能直接读describe和summarize的真实输出不用你手动贴数据概况。配置阶段花十分钟把路径和端口理顺后面写论文的回归流程会顺畅很多。
