S

Stata-MCP集成

@hanlulong/stata-mcp
4 Stars 602 次浏览 hanlulong 更新于 2026-08-23

为Stata统计软件与VS Code、Cursor等代码编辑器之间提供了一个桥梁，使用户能够直接从编辑器运行Stata命令，实时查看输出，并获得由人工智能驱动的Stata编码辅助功能。

开发者工具学术研究

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

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

服务介绍

Stata MCP 扩展 for VS Code 和 Cursor

VS Code Marketplace
GitHub license

此扩展通过使用 Model Context Protocol (MCP) 为 Visual Studio Code 和 Cursor IDE 提供 Stata 集成。它允许你：

  • 直接从 VS Code 或 Cursor 运行 Stata 命令
  • 执行选择的代码或整个 .do 文件
  • 在编辑器中实时查看 Stata 输出
  • 通过 MCP 协议获得 AI 助手集成
  • 在 Cursor IDE 中体验带有 Stata 上下文的增强 AI 编码

特性

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

寻找其他 Stata 集成？

  • 使用 Notepad++ 和 Sublime Text 3 的 Stata？请参阅 这里
  • 在 Claude 或 Cline 中使用 Stata MCP？请参阅 这里
  • 通过 Jupyter 使用 Stata？请参阅 这里

安装选项

选项 1：VS Code 市场

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

code --install-extension DeepEcon.stata-mcp

或者：

  1. 打开 VS Code
  2. 转到扩展视图 (Ctrl+Shift+X)
  3. 搜索 "Stata MCP"
  4. 点击 "安装"

选项 2：Cursor 扩展商店

对于 Cursor 用户：

cursor --install-extension DeepEcon.stata-mcp

或者：

  1. 打开 Cursor
  2. 转到设置 > 扩展 > 浏览扩展
  3. 搜索 "Stata MCP"
  4. 点击 "安装"

选项 3：手动安装

如果你更喜欢手动安装：

  1. 从 GitHub 发布页面 下载最新的 .vsix 文件
  2. 对于 VS Code：
    • 打开 VS Code
    • 转到扩展视图
    • 点击右上角的 "..." 菜单
    • 选择 "从 VSIX 安装..."
    • 导航并选择下载的 .vsix 文件
  3. 对于 Cursor：
    • 在终端中运行此命令：cursor --install-extension path/to/stata-mcp-0.1.5.vsix

注意：初始安装需要设置依赖项，这可能需要最多 2 分钟才能完成。请耐心等待这个一次性设置过程，并等待服务器启动。所有后续运行将立即启动。

扩展设置

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

  • stata-vscode.stataPath: Stata 安装目录的路径
  • stata-vscode.pythonPath: Python 解释器的路径。如果未设置，扩展将尝试使用系统自带的 Python 或 Anaconda 基础环境
  • 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.useUvForPython: 使用 uv 进行 Python 环境管理，这更快且更可靠（默认：true）

光标MCP配置

要在光标中启用与Stata的人工智能集成，您需要配置MCP连接：

  1. 创建或编辑MCP配置文件：

    • 在macOS/Linux上: ~/.cursor/mcp.json
    • 在Windows上: %USERPROFILE%\.cursor\mcp.json

  2. 向您的mcp.json文件添加以下配置：

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

  1. 如果您已经在文件中有其他MCP配置，只需将"stata-mcp"部分添加到现有的"mcpServers"对象中。

  2. 保存文件并重启光标

此配置允许光标的AI与通过扩展启动的Stata MCP服务器通信。正确配置后，AI助手可以：

  • 与您的Stata会话交互
  • 执行Stata命令
  • 理解您的数据集和变量
  • 提供更具上下文感知的编码辅助
  • 帮助进行数据分析和可视化

要求

  • 您的计算机上安装了Stata 15或更高版本
  • UV包管理器（自动安装或按需手动安装）

Python环境管理

本扩展使用uv，这是一个用Rust编写的快速Python包安装程序，来管理Python依赖项。主要特点包括：

  • 自动化的Python设置及依赖管理
  • 创建不会与您的系统冲突的隔离环境
  • 支持Windows、macOS和Linux跨平台操作
  • 比传统的pip安装快10至100倍

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

  1. 手动安装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
  2. 按照故障排除步骤重新安装扩展

您可以使用stata-vscode.useUvForPython设置来控制是否使用UV（默认：true）。

使用方法

  1. 打开一个Stata .do文件
  2. 通过以下方式运行命令：
    • 运行选区：选择Stata代码并按下Ctrl+Shift+Enter（或Mac上的Cmd+Shift+Enter）
    • 运行文件：按下Ctrl+Shift+D（或Mac上的Cmd+Shift+D）来运行整个.do文件
  3. 在编辑器面板中查看输出

工作原理

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

  1. 命令执行：运行 Stata 命令并立即查看结果
  2. 上下文感知：AI 助手理解您的 Stata 数据和命令
  3. 提高生产力：获取智能代码建议和文档

故障排除

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

Windows

  1. 关闭所有 VS Code/Cursor 窗口

  2. 打开任务管理器（Ctrl+Shift+Esc）：

    • 转到“进程”选项卡
    • 查找任何正在运行的 Python 或 uvicorn 进程
    • 选择每个进程并点击“结束任务”

  3. 删除扩展文件夹：

    • 按 Win+R，输入 %USERPROFILE%\.vscode\extensions 并按 Enter 键
    • 删除 deepecon.stata-mcp-0.x.x 文件夹（其中 x.x 是版本号）
    • 对于 Cursor：路径为 %USERPROFILE%\.cursor\extensions

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

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

  5. 重启计算机（推荐但可选）

  6. 从市场安装最新版本的扩展程序

macOS/Linux

  1. 关闭所有 VS Code/Cursor 窗口

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

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

  3. 删除扩展文件夹：

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

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

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

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

  5. 重启终端或计算机（推荐但可选）

  6. 从市场安装最新版本的扩展程序

其他故障排除提示

  • 如果你看到关于找不到 Python 或 UV 的错误，请确保它们在你的系统 PATH 中：

    • Windows：在开始菜单中输入“环境变量”并添加安装路径
    • macOS/Linux：将路径添加到你的 ~/.bashrc、~/.zshrc 或等效文件中

  • 如果你遇到权限错误：

    • Windows：以管理员身份运行 VS Code/Cursor
    • macOS/Linux：使用 ls -la 检查文件夹权限，如果需要的话使用 chmod 进行修复

  • 如果扩展仍然无法初始化：

    1. 打开输出面板（View -> Output）
    2. 从下拉列表中选择 "Stata-MCP"
    3. 检查日志中的具体错误信息
    4. 如果看到与 Python 相关的错误，尝试手动创建一个 Python 3.11 虚拟环境： 
      # 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 上提交问题时，请提供以下信息：

  • 输出面板中的完整错误消息（View -> Output -> Stata-MCP）
  • 你的操作系统和版本
  • VS Code/Cursor 版本
  • Python 版本 (python --version)
  • UV 版本 (uv --version)
  • 复现问题的步骤
  • 任何相关的日志文件或截图
  • 如果适用，MCP 配置文件的内容

这些详细信息将帮助我们更快地识别和解决问题。你可以在 GitHub Issues 提交问题。

许可

MIT

致谢

由 Lu Han 创建
由 DeepEcon 发布

查看源码 项目主页

相关 MCP 服务

LeetCode(力扣)
jinzcdev/leetcode-mcp-server
MCP 服务器实现 LeetCode API 集成，支持自动化获取编程题库、用户数据和竞赛信息。
可视化图表-MCP-Server
antvis/mcp-server-chart
这是一个基于AntV的模型上下文协议服务器，用于生成图表。它支持超过20种类型的图表，并且可以与多种桌面应用程序和平台一起使用。
微软Playwright
@microsoft/playwright-mcp
一种模型上下文协议服务器，它使大型语言模型能够通过结构化的可访问性快照与网页交互，而无需使用视觉模型或截图。
MCP上下文模型文档
@upstash/context7-mcp
一种模型上下文协议服务器，它从库中直接获取最新、特定版本的文档和代码示例并将其引入LLM提示中，帮助开发人员在无需过时或虚构信息的情况下获得准确的答案。