Stata Mcp

MIT License

hanlulong

Stata MCP 扩展（适用于 VS Code 和 Cursor）

本扩展通过 Model Context Protocol (MCP) 为 Visual Studio Code 和 Cursor IDE 提供 Stata 集成功能。主要特性包括：

直接从 VS Code 或 Cursor 运行 Stata 命令
执行选中代码段或完整 .do 文件
实时查看 Stata 输出结果
通过 MCP 协议获得 AI 助手集成
在 Cursor 或 Cline 中体验增强的 AI 编程功能

功能特色

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

演示视频

观看本扩展如何增强您在 Cursor（或 VS Code）中使用 Stata 的工作流程：

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

_{演示提示词："编写并执行 Stata do-file，确保所有情况下都使用完整绝对路径。加载 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 应用商店安装本扩展。

bash 复制代码

code --install-extension DeepEcon.stata-mcp

或：

打开 VS Code
进入扩展视图 (Ctrl+Shift+X)
搜索 "Stata MCP"
点击"安装"

方案 2：通过 .vsix 文件安装

从发布页面下载扩展包 stata-mcp-0.2.1.vsix
使用以下任一方法安装：

bash 复制代码

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

或：

打开 VS Code
进入扩展视图 (Ctrl+Shift+X)
点击右上角"..."菜单
选择"从 VSIX 安装..."
导航并选择下载的 .vsix 文件

Cursor 安装方法

从发布页面下载扩展包 stata-mcp-0.2.2.vsix
使用以下任一方法安装：

bash 复制代码

cursor --install-extension path/to/stata-mcp-0.2.2.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 .do 文件
运行命令方式：
- 运行选中代码：选择 Stata 代码后按 Ctrl+Shift+Enter（Mac 上为 Cmd+Shift+Enter）
- 运行整个文件：按 Ctrl+Shift+D（Mac 上为 Cmd+Shift+D）运行整个 .do 文件
在编辑器面板查看输出结果

工作原理

本扩展创建一个本地 MCP 服务器，将您的编辑器连接到 Stata，实现以下功能：

命令执行：运行 Stata 命令并即时查看结果
上下文感知：AI 助手理解您的 Stata 数据和命令
效率提升：获取智能代码建议和文档

Cursor MCP 配置

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

打开 Cursor
按 Ctrl+Shift+P（Mac 上为 Cmd+Shift+P）打开命令面板
输入"Stata: Test MCP Server Connection"并按 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 服务器配置：

json 复制代码

{
  "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 服务器配置：

json 复制代码

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

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

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

json 复制代码

"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 中使用本扩展：

确保 Stata MCP 扩展已在 VS Code 或 Cursor 中安装并正在运行

安装 mcp-proxy：

bash 复制代码

# 使用 pip
pip install mcp-proxy

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

查找 mcp-proxy 路径：

bash 复制代码

# Mac/Linux
which mcp-proxy

# Windows (PowerShell)
(Get-Command mcp-proxy).Path

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

Windows（通常位于 %APPDATA%\Claude Desktop\claude_desktop_config.json）：
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）：
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：

bash 复制代码

# 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 并运行：
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

重启计算机（推荐但可选）
从应用商店安装最新版扩展

macOS/Linux 系统

关闭所有 VS Code/Cursor 窗口

终止运行的 Python 进程：

bash 复制代码

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

删除扩展文件夹：

bash 复制代码

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

手动安装 UV（如需）：

bash 复制代码

# 使用 curl：
curl -LsSf https://astral.sh/uv/install.sh | sh

# 或使用 wget：
wget -qO- https://astral.sh/uv/install.sh | sh

重启终端或计算机（推荐但可选）
从应用商店安装最新版扩展

其他故障排除技巧

如果看到关于 Python 或 UV 未找到的错误，请确保它们位于系统 PATH 中：
- Windows：在开始菜单输入"环境变量"并添加安装路径
- macOS/Linux：将路径添加到 ~/.bashrc、~/.zshrc 或等效文件
如果遇到权限错误：
- Windows：以管理员身份运行 VS Code/Cursor
- macOS/Linux：使用 ls -la 检查文件夹权限，如需使用 chmod 修复
如果扩展仍无法初始化：
1. 打开输出面板（视图 -> 输出）
2. 从下拉菜单中选择"Stata-MCP"
3. 检查日志中的具体错误信息
4. 如果看到 Python 相关错误，尝试手动创建 Python 3.11 虚拟环境：
  bash 复制代码
```
# Windows
py -3.11 -m venv .venv

# macOS/Linux
python3.11 -m venv .venv
```
对于持续性问题：
1. 检查系统 Python 安装：python --version 或 python3 --version
2. 验证 UV 安装：uv --version
3. 确保已安装 Python 3.11 或更高版本
4. 检查杀毒软件是否阻止 Python 或 UV 可执行文件

在 GitHub 上提交问题时，请提供：

输出面板中的完整错误信息（视图 -> 输出 -> Stata-MCP）
操作系统及版本
VS Code/Cursor 版本
Python 版本（python --version）
UV 版本（uv --version）
问题重现步骤
任何相关日志文件或截图
如适用，您的 MCP 配置文件内容

这些详细信息将帮助我们更快地识别和修复问题。您可以在以下位置提交问题：GitHub Issues

许可证

MIT

致谢

作者：Lu Han
发布方：DeepEcon

Stata Mcp

Stata MCP 扩展（适用于 VS Code 和 Cursor）

功能特色

演示视频

系统要求

安装指南

VS Code 安装方法

方案 1：通过 VS Code 应用商店

方案 2：通过 .vsix 文件安装

Cursor 安装方法

扩展设置

使用方法

工作原理

Cursor MCP 配置

Cursor 配置文件路径

手动配置 Cursor

Cursor 配置故障排除

Cline MCP 配置

Cline 配置故障排除

Claude Desktop MCP 配置

Python 环境管理

故障排除

Windows 系统

macOS/Linux 系统

其他故障排除技巧

许可证

致谢

3d Printer Server

Abap Adt

Ableton Live Server

Ableton Mcp

Cursor Db Mcp

猫目

热门推荐

关于

关注我们