Stata MCP 扩展 for VS Code 和 Cursor

VS Code Marketplace GitHub all releases

该扩展为 Visual Studio Code 和 Cursor IDE 提供了基于模型上下文协议（MCP）的 Stata 集成。该扩展允许您：

直接从 VS Code 或 Cursor 运行 Stata 命令
执行选中的代码或整个 .do 文件
实时查看 Stata 输出
通过 MCP 协议获得 AI 助手集成
体验 Cursor 或 Cline 的增强 AI 编码功能
选择您的 Stata 版本（MP、SE 或 IC）

功能

运行 Stata 命令：直接从编辑器中执行选中的代码或整个 .do 文件
语法高亮：支持 Stata 的 .do、.ado、.mata 和 .doh 文件的完整语法
AI 助手集成：通过 MCP 提供上下文帮助和代码建议
跨平台：支持 Windows、macOS 和 Linux
自动检测 Stata：自动找到您的 Stata 安装路径
实时输出：在编辑器中即时查看 Stata 结果

演示

观看该扩展如何通过 Cursor（或 VS Code）和 AI 助手增强您的 Stata 工作流程：

Stata MCP 扩展演示

🎬 完整视频版本 | 📄 查看生成的 PDF 报告

_{演示提示：“编写并执行 Stata do 文件，确保在所有情况下使用完整的绝对文件路径。加载 auto 数据集（webuse auto）并为每个变量生成汇总统计信息。识别并提取数据集中的关键特征，生成相关图表并将其保存在名为 plots 的文件夹中。进行回归分析以检查汽车价格的主要决定因素。将所有输出导出到 LaTeX 文件并进行编译。自动解决任何编译错误，并确保 LaTeX 编译时间不超过 10 秒。所有代码错误都应作为工作流程的一部分被识别和解决。”}

寻找其他 Stata 集成？

在 Notepad++ 和 Sublime Text 3 中使用 Stata？请参见此处

在不安装此扩展的情况下在 Claude Desktop 中使用 Stata MCP？请参见此处

通过 Jupyter 使用 Stata？请参见此处

要求

在您的机器上安装 Stata 17 或更高版本
UV 包管理器（自动安装或可以手动安装）

安装

注意： 初始安装需要设置依赖项，可能需要长达 2 分钟才能完成。请在此一次性设置过程中耐心等待。所有后续运行将立即启动。

VS Code 安装

选项 1：从 VS Code 市场安装

直接从 VS Code 市场安装此扩展。

code --install-extension DeepEcon.stata-mcp

或者：

打开 VS Code
转到扩展视图（Ctrl+Shift+X）
搜索“Stata MCP”
点击“安装”

选项 2：从 .vsix 文件安装

从发布页面下载扩展包 stata-mcp-0.2.4.vsix。
使用以下方法之一进行安装：

code --install-extension path/to/stata-mcp-0.2.4.vsix

或者：

打开 VS Code
转到扩展视图（Ctrl+Shift+X）
点击右上角的“...”菜单
选择“从 VSIX 安装...”
导航并选择下载的 .vsix 文件

Cursor 安装

从发布页面下载扩展包 stata-mcp-0.2.4.vsix。
使用以下方法之一进行安装：

cursor --install-extension path/to/stata-mcp-0.2.4.vsix

或者：

打开 Cursor
转到扩展视图
点击“...”菜单
选择“从 VSIX 安装”
导航并选择下载的 .vsix 文件

从 0.1.8 版本开始，该扩展集成了一个名为 uv 的快速 Python 包安装程序来设置环境。如果您的系统上未找到 uv，扩展将尝试自动安装它。

扩展设置

您可以通过 VS Code 设置自定义扩展行为：

stata-vscode.stataPath：Stata 安装目录的路径
stata-vscode.mcpServerHost：MCP 服务器的主机（默认：localhost）
stata-vscode.mcpServerPort：MCP 服务器的端口（默认：4000）
stata-vscode.autoStartServer：在扩展激活时自动启动 MCP 服务器（默认：true）
stata-vscode.debugMode：在输出面板中显示详细的调试信息（默认：false）
stata-vscode.forcePort：强制 MCP 服务器使用指定端口，即使它已被占用（默认：false）
stata-vscode.clineConfigPath：Cline 配置文件的自定义路径（可选，默认为标准位置）
stata-vscode.runFileTimeout：“运行文件”操作的超时时间（默认：600 秒 / 10 分钟）
stata-vscode.stataEdition：使用的 Stata 版本（MP、SE、IC）- 默认：MP

使用

打开一个 Stata .do 文件
使用以下方法运行命令：
- 运行选中代码：选择 Stata 代码并按 Ctrl+Shift+Enter（或 Mac 上的 Cmd+Shift+Enter）
- 运行文件：按 Ctrl+Shift+D（或 Mac 上的 Cmd+Shift+D）运行整个 .do 文件
在编辑器面板中查看输出
选择 Stata 版本：在扩展设置中选择您首选的 Stata 版本（MP、SE 或 IC）

工作原理

该扩展创建了一个本地 MCP 服务器，将您的编辑器连接到 Stata，从而实现：

命令执行：运行 Stata 命令并即时查看结果
上下文感知：AI 助手理解您的 Stata 数据和命令
增强生产力：获得智能代码建议和文档

Cursor MCP 配置

该扩展自动配置 Cursor MCP 集成。要验证其是否正常工作：

打开 Cursor
按 Ctrl+Shift+P（或 Mac 上的 Cmd+Shift+P）打开命令面板
输入“Stata: 测试 MCP 服务器连接”并按 Enter
如果服务器正确连接，您应该会看到成功消息

Cursor 配置文件路径

Cursor MCP 配置文件的位置因操作系统而异：

macOS：
- 主要位置：~/.cursor/mcp.json
- 替代位置：~/Library/Application Support/Cursor/User/mcp.json
Windows：
- 主要位置：%USERPROFILE%\.cursor\mcp.json
- 替代位置：%APPDATA%\Cursor\User\mcp.json
Linux：
- 主要位置：~/.cursor/mcp.json
- 替代位置：~/.config/Cursor/User/mcp.json

手动配置 Cursor

如果需要手动配置 Cursor MCP：

创建或编辑 MCP 配置文件：
- macOS/Linux：~/.cursor/mcp.json
- Windows：%USERPROFILE%\.cursor\mcp.json

添加 Stata MCP 服务器配置：

{
  "mcpServers": {
    "stata-mcp": {
      "url": "http://localhost:4000/mcp",
      "transport": "sse"
    }
  }
}

如果文件中已包含其他 MCP 服务器，只需将 "stata-mcp" 条目添加到现有的 "mcpServers" 对象中。
保存文件并重启 Cursor。

解决 Cursor 配置问题

如果 Cursor 无法识别 Stata MCP 服务器：

验证 MCP 服务器是否正在运行
检查配置文件是否存在且内容正确
尝试重启 Cursor
确保没有与其他运行应用程序的端口冲突

Cline MCP 配置

打开您的 Cline MCP 设置文件：
- macOS：~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
- Windows：%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
- Linux：~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

添加 Stata MCP 服务器配置：

{
  "mcpServers": {
    "stata-mcp": {
      "url": "http://localhost:4000/mcp",
      "transport": "sse"
    }
  }
}

如果文件中已包含其他 MCP 服务器，只需将 "stata-mcp" 条目添加到现有的 "mcpServers" 对象中。
保存文件并重启 VS Code。

您还可以通过 VS Code 设置配置 Cline：

"cline.mcpSettings": {
  "stata-mcp": {
    "url": "http://localhost:4000/mcp",
    "transport": "sse"
  }
}

解决 Cline 配置问题

如果 Cline 无法识别 Stata MCP 服务器：

验证 MCP 服务器是否正在运行（状态栏应显示“Stata”）
检查配置文件是否存在且内容正确
尝试重启 VS Code
检查扩展输出面板（查看 > 输出 > Stata MCP）以获取任何错误信息

Claude Desktop MCP 配置

您可以通过 mcp-proxy 在 Claude Desktop 中使用此扩展：

在尝试配置 Claude Desktop 之前，请确保 Stata MCP 扩展已安装在 VS Code 或 Cursor 中并且当前正在运行

安装 mcp-proxy：

# 使用 pip
pip install mcp-proxy

# 或使用 uv（更快）
uv install mcp-proxy

找到 mcp-proxy 的路径：

# 在 Mac/Linux 上
which mcp-proxy

# 在 Windows 上（PowerShell）
(Get-Command mcp-proxy).Path

通过编辑 MCP 配置文件配置 Claude Desktop：

在 Windows 上（通常在 %APPDATA%\Claude Desktop\claude_desktop_config.json）：

{
  "mcpServers": {
    "stata-mcp": {
      "command": "mcp-proxy",
      "args": ["http://127.0.0.1:4000/mcp"]
    }
  }
}

在 macOS 上（通常在 ~/Library/Application Support/Claude Desktop/claude_desktop_config.json）：

{
  "mcpServers": {
    "stata-mcp": {
      "command": "/path/to/mcp-proxy",
      "args": ["http://127.0.0.1:4000/mcp"]
    }
  }
}

将 /path/to/mcp-proxy 替换为步骤 3 中找到的实际路径。

重启 Claude Desktop
Claude Desktop 将自动发现可用的 Stata 工具，允许您直接从对话中运行 Stata 命令和分析数据。

注意： 有一种替代方法可以在不安装此扩展的情况下在 Claude Desktop 中使用 Stata MCP。请参见此处。

Python 环境管理

该扩展使用 uv，一个用 Rust 构建的快速 Python 包安装程序，来管理 Python 依赖项。主要功能：

自动 Python 设置和依赖项管理
创建不会与系统冲突的隔离环境
支持 Windows、macOS 和 Linux
比传统 pip 安装快 10-100 倍

如果在安装过程中遇到任何 UV 相关错误：

手动安装 UV：

# Windows（以管理员身份运行 PowerShell）
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

按照故障排除步骤重新安装扩展

从 0.1.8 版本开始，该扩展集成了快速 Python 包安装程序 uv 来设置环境。如果您的系统上未找到 uv，扩展将尝试自动安装它。

故障排除

如果您在使用扩展时遇到问题，请按照以下步骤执行干净的重新安装：

Windows

关闭所有 VS Code/Cursor 窗口
打开任务管理器（Ctrl+Shift+Esc）：
- 转到“进程”选项卡
- 查找任何正在运行的 Python 或 uvicorn 进程
- 选择每个进程并点击“结束任务”
删除扩展文件夹：
- 按 Win+R，输入 %USERPROFILE%\.vscode\extensions 并按 Enter
- 删除文件夹 deepecon.stata-mcp-0.x.x（其中 x.x 是版本号）
- 对于 Cursor：路径为 %USERPROFILE%\.cursor\extensions

手动安装 UV（如果需要）：

# 以管理员身份打开 PowerShell 并运行：
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

重启计算机（推荐但可选）
从市场安装最新版本的扩展

macOS/Linux

关闭所有 VS Code/Cursor 窗口

终止任何正在运行的 Python 进程：

# 查找 Python 进程
ps aux | grep python
# 终止它们（将 <PID> 替换为您找到的进程号）
kill -9 <PID>

删除扩展文件夹：

# 对于 VS Code：
rm -rf ~/.vscode/extensions/deepecon.stata-mcp-0.x.x
# 对于 Cursor：
rm -rf ~/.cursor/extensions/deepecon.stata-mcp-0.x.x