This extension provides Stata integration for Visual Studio Code and Cursor IDE using the Model Context Protocol (MCP).

The extension allows you to:

• Run Stata commands directly from VS Code or Cursor
• Execute selections or entire .do files
• View Stata output in the editor in real-time
• Get AI assistant integration through the MCP protocol
• Experience enhanced AI coding with Cursor, Cline, Claude Code, or Codex
• Choose your Stata edition (MP, SE, or BE)

• Run Stata Commands: Execute selections or entire .do files directly from your editor
• Syntax Highlighting: Full syntax support for Stata .do, .ado, .mata, and .doh files
• AI Assistant Integration: Contextual help and code suggestions via MCP
• Cross-platform: Works on Windows, macOS, and Linux
• Automatic Stata Detection: Automatically finds your Stata installation
• Real-time Output: See Stata results instantly in your editor

Watch how this extension enhances your Stata workflow with Cursor (or VS Code) and AI assistance:

🎬 Full Video Version   |   📄 View Generated PDF Report

_{Demo prompt: "Write and execute Stata do-files, ensuring that full absolute file paths are used in all cases. Load the auto dataset (webuse auto) and generate summary statistics for each variable. Identify and extract key features from the dataset, produce relevant plots, and save them in a folder named plots. Conduct a regression analysis to examine the main determinants of car prices. Export all outputs to a LaTeX file and compile it. Address any compilation errors automatically, and ensure that LaTeX compilation does not exceed 10 seconds. All code errors should be identified and resolved as part of the workflow."}

Looking for other Stata integrations?

• Use Stata with Notepad++ and Sublime Text 3? See here
• Use Stata via Jupyter? See here

• Stata 17 or higher installed on your machine
• UV package manager (automatically installed or can be installed manually if needed)

Note: Initial installation requires setting up dependencies which may take up to 2 minutes to complete. Please be patient during this one-time setup process. All subsequent runs will start instantly.

Install this extension directly from the VS Code Marketplace.

code --install-extension DeepEcon.stata-mcp

Or:

1. Open VS Code
2. Go to Extensions view (Ctrl+Shift+X)
3. Search for "Stata MCP"
4. Click "Install"

1. Download the extension package stata-mcp-0.3.6.vsix from the releases page.
2. Install using one of these methods:

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

Or:

1. Open VS Code
2. Go to Extensions view (Ctrl+Shift+X)
3. Click on "..." menu in the top-right
4. Select "Install from VSIX..."
5. Navigate to and select the downloaded .vsix file

1. Download the extension package stata-mcp-0.3.6.vsix from the releases page.
2. Install using one of these methods:

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

Or:

1. Open Cursor
2. Go to Extensions view
3. Click on the "..." menu
4. Select "Install from VSIX"
5. Navigate to and select the downloaded .vsix file

Starting with version 0.1.8, the extension integrates a fast Python package installer called uv to set up the environment. If uv is not found on your system, the extension will attempt to install it automatically.

1. Open a Stata .do file
2. Run commands using:
   • Run Selection: Select Stata code and press Ctrl+Shift+Enter (or Cmd+Shift+Enter on Mac), or click the first button (▶️) in the editor toolbar
   • Run File: Press Ctrl+Shift+D (or Cmd+Shift+D on Mac) to run the entire .do file, or click the second button in the toolbar
   • Interactive Mode: Select Stata code and click the 📊 button in the editor toolbar to run the selection in an interactive window, or click without selection to run the entire file
3. View output in the editor panel or interactive window

Access the data viewer to inspect your Stata dataset:

1. Click the View Data button (fourth button, table icon) in the editor toolbar
2. View your current dataset in a table format
3. Filter data: Use Stata if conditions to view subsets of your data
   • Example: price > 5000 & mpg < 30
   • Type your condition in the filter box and click "Apply"
   • Click "Clear" to remove the filter and view all data

Control how graphs are displayed:

1. Auto-display graphs: Graphs are automatically shown when generated (default: enabled)
   • Disable in Extension Settings: stata-vscode.autoDisplayGraphs
2. Choose display method:
   • VS Code webview (default): Graphs appear in a panel within VS Code
   • External browser: Graphs open in your default web browser
   • Change in Extension Settings: stata-vscode.graphDisplayMethod

Select your preferred Stata edition (MP, SE, or BE) in the Extension Settings

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

This extension uses uv, a fast Python package installer built in Rust, to manage Python dependencies. Key features:

• Automatic Python setup and dependency management
• Creates isolated environments that won't conflict with your system
• Works across Windows, macOS, and Linux
• 10-100x faster than traditional pip installations

If you encounter any UV-related errors during installation:

1. Install UV manually:

   # Windows (PowerShell as Administrator)
   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
   
   # macOS/Linux
   curl -LsSf https://astral.sh/uv/install.sh | sh

2. Follow the Troubleshooting steps to reinstall the extension

Starting with version 0.1.8, this extension integrates the fast Python package installer uv to set up the environment. If uv is not found on your system, the extension will attempt to install it automatically.

Looking for internal architecture notes?

• See docs/REPO_STRUCTURE.md for a quick map of directories and build artefacts.
• See docs/incidents/README.md for an index of historical debugging write-ups (streaming, notifications, timeouts, etc.).
• See tests/README.md for the current set of diagnostics and accompanying Stata fixtures.

If you encounter issues with the extension, follow these steps to perform a clean reinstallation:

1. Close all VS Code/Cursor windows

2. Open Task Manager (Ctrl+Shift+Esc):

   • Go to the "Processes" tab
   • Look for any running Python or uvicorn processes
   • Select each one and click "End Task"

3. Remove the extension folder:

   • Press Win+R, type %USERPROFILE%\.vscode\extensions and press Enter
   • Delete the folder deepecon.stata-mcp-0.x.x (where x.x is the version number)
   • For Cursor: The path is %USERPROFILE%\.cursor\extensions

4. Install UV manually (if needed):

   # Open PowerShell as Administrator and run:
   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

5. Restart your computer (recommended but optional)

6. Install the latest version of the extension from the marketplace

1. Close all VS Code/Cursor windows

2. Kill any running Python processes:

   # Find Python processes
   ps aux | grep python
   # Kill them (replace <PID> with the process numbers you found)
   kill -9 <PID>

3. Remove the extension folder:

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

4. Install UV manually (if needed):

   # Using curl:
   curl -LsSf https://astral.sh/uv/install.sh | sh
   
   # Or using wget:
   wget -qO- https://astral.sh/uv/install.sh | sh

5. Restart your terminal or computer (recommended but optional)

6. Install the latest version of the extension from the marketplace

• If you see errors about Python or UV not being found, make sure they are in your system's PATH:

  • Windows: Type "Environment Variables" in the Start menu and add the installation paths
  • macOS/Linux: Add the paths to your ~/.bashrc, ~/.zshrc, or equivalent

• If you get permission errors:

  • Windows: Run VS Code/Cursor as Administrator
  • macOS/Linux: Check folder permissions with ls -la and fix with chmod if needed

• If the extension still fails to initialize:

  1. Open the Output panel (View -> Output)
  2. Select "Stata-MCP" from the dropdown
  3. Check the logs for specific error messages
  4. If you see Python-related errors, try manually creating a Python 3.11 virtual environment:

     # Windows
     py -3.11 -m venv .venv
     
     # macOS/Linux
     python3.11 -m venv .venv

• For persistent issues:

  1. Check your system's Python installation: python --version or python3 --version
  2. Verify UV installation: uv --version
  3. Make sure you have Python 3.11 or later installed
  4. Check if your antivirus software is blocking Python or UV executables

• If you're having issues with a specific Stata edition:

  1. Make sure the selected Stata edition (MP, SE, or BE) matches what's installed on your system
  2. Try changing the stata-vscode.stataEdition setting to match your installed version
  3. Restart the extension after changing settings

When opening an issue on GitHub, please provide:

• The complete error message from the Output panel (View -> Output -> Stata-MCP)
• Your operating system and version
• VS Code/Cursor version
• Python version (python --version)
• UV version (uv --version)
• Steps to reproduce the issue
• Any relevant log files or screenshots
• The content of your MCP configuration file if applicable

This detailed information will help us identify and fix the issue more quickly. You can open issues at: GitHub Issues

MIT

Created by Lu Han, Published by DeepEcon.ai