Stata MCP Extension for VS Code and Cursor

• 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 or Cline

Features

• 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

Demo

Looking for other Stata integrations?

Requirements

• Stata 17 or higher installed on your machine

• UV package manager (automatically installed or can be installed manually if needed)

Installation

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.

VS Code Installation

Option 1: From VS Code Marketplace

1. Open VS Code

2. Go to Extensions view (Ctrl+Shift+X)

3. Search for "Stata MCP"

4. Click "Install"

Option 2: From .vsix file

1. Download the extension package stata-mcp-0.2.1.vsix from the releases page.

2. Install using one of these methods:

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

Cursor Installation

1. Download the extension package stata-mcp-0.2.2.vsix from the releases page.

2. Install using one of these methods:

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

Extension Settings

• stata-vscode.stataPath: Path to Stata installation directory

• stata-vscode.mcpServerHost: Host for MCP server (default: localhost)

• stata-vscode.mcpServerPort: Port for the MCP server (default: 4000)

• stata-vscode.autoStartServer: Automatically start MCP server when extension activates (default: true)

• stata-vscode.debugMode: Show detailed debug information in output panel (default: false)

• stata-vscode.forcePort: Force the MCP server to use the specified port even if it's already in use (default: false)

• stata-vscode.clineConfigPath: Custom path to Cline configuration file (optional, defaults to standard locations)

• stata-vscode.runFileTimeout: Timeout in seconds for 'Run File' operations (default: 600 seconds / 10 minutes)

Usage

1. Open a Stata .do file

2. Run commands using:

3. View output in the editor panel

How It Works

1. Command Execution: Run Stata commands and see results instantly

2. Context Awareness: AI assistants understand your Stata data and commands

3. Enhanced Productivity: Get intelligent code suggestions and documentation

Cursor MCP Configuration

1. Open Cursor

2. Press Ctrl+Shift+P (or Cmd+Shift+P on Mac) to open the Command Palette

3. Type "Stata: Test MCP Server Connection" and press Enter

4. You should see a success message if the server is properly connected

Cursor Configuration File Paths

• macOS:

• Windows:

• Linux:

Manual Cursor Configuration

1. Create or edit the MCP configuration file:

2. Add the Stata MCP server configuration:

3. If the file already contains other MCP servers, just add the "stata-mcp" entry to the existing "mcpServers" object.

4. Save the file and restart Cursor.

Troubleshooting Cursor Configuration

1. Verify the MCP server is running

2. Check that the configuration file exists with the correct content

3. Try restarting Cursor

4. Ensure there are no port conflicts with other running applications

Cline MCP Configuration

1. Open your Cline MCP settings file:

2. Add the Stata MCP server configuration:

3. If the file already contains other MCP servers, just add the "stata-mcp" entry to the existing "mcpServers" object.

4. Save the file and restart VS Code.

Troubleshooting Cline Configuration

1. Verify the MCP server is running (Status bar should show "Stata")

2. Check that the configuration file exists with the correct content

3. Try restarting VS Code

4. Check the extension output panel (View > Output > Stata MCP) for any errors

Claude Desktop MCP Configuration

1. Make sure the Stata MCP extension is installed in VS Code or Cursor and currently running before attempting to configure Claude Desktop

2. Install mcp-proxy:

3. Find the path to mcp-proxy:

4. Configure Claude Desktop by editing the MCP config file:On Windows (typically at %APPDATA%\Claude Desktop\claude_desktop_config.json):On macOS (typically at ~/Library/Application Support/Claude Desktop/claude_desktop_config.json):Replace /path/to/mcp-proxy with the actual path you found in step 3.

5. Restart Claude Desktop

6. Claude Desktop will automatically discover the available Stata tools, allowing you to run Stata commands and analyze data directly from your conversations.

Note: There is an alternative way to use Stata MCP in Claude Desktop without installing this extension. See here.

Python Environment Management

• 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

1. Install UV manually:

2. Follow the Troubleshooting steps to reinstall the extension

Troubleshooting

Windows

1. Close all VS Code/Cursor windows

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

3. Remove the extension folder:

4. Install UV manually (if needed):

5. Restart your computer (recommended but optional)

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

macOS/Linux

1. Close all VS Code/Cursor windows

2. Kill any running Python processes:

3. Remove the extension folder:

4. Install UV manually (if needed):

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

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

Additional Troubleshooting Tips

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

• If you get permission errors:

• If the extension still fails to initialize:

• For persistent issues:

• 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

License

Credits

Stata MCP Extension for VS Code and Cursor

• 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 or Cline

Features

• 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

Demo

Looking for other Stata integrations?

Requirements

• Stata 17 or higher installed on your machine

• UV package manager (automatically installed or can be installed manually if needed)

Installation

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.

VS Code Installation

Option 1: From VS Code Marketplace

1. Open VS Code

2. Go to Extensions view (Ctrl+Shift+X)

3. Search for "Stata MCP"

4. Click "Install"

Option 2: From .vsix file

1. Download the extension package stata-mcp-0.2.1.vsix from the releases page.

2. Install using one of these methods:

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

Cursor Installation

1. Download the extension package stata-mcp-0.2.2.vsix from the releases page.

2. Install using one of these methods:

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

Extension Settings

• stata-vscode.stataPath: Path to Stata installation directory

• stata-vscode.mcpServerHost: Host for MCP server (default: localhost)

• stata-vscode.mcpServerPort: Port for the MCP server (default: 4000)

• stata-vscode.autoStartServer: Automatically start MCP server when extension activates (default: true)

• stata-vscode.debugMode: Show detailed debug information in output panel (default: false)

• stata-vscode.forcePort: Force the MCP server to use the specified port even if it's already in use (default: false)

• stata-vscode.clineConfigPath: Custom path to Cline configuration file (optional, defaults to standard locations)

• stata-vscode.runFileTimeout: Timeout in seconds for 'Run File' operations (default: 600 seconds / 10 minutes)

Usage

1. Open a Stata .do file

2. Run commands using:

3. View output in the editor panel

How It Works

1. Command Execution: Run Stata commands and see results instantly

2. Context Awareness: AI assistants understand your Stata data and commands

3. Enhanced Productivity: Get intelligent code suggestions and documentation

Cursor MCP Configuration

1. Open Cursor

2. Press Ctrl+Shift+P (or Cmd+Shift+P on Mac) to open the Command Palette

3. Type "Stata: Test MCP Server Connection" and press Enter

4. You should see a success message if the server is properly connected

Cursor Configuration File Paths

• macOS:

• Windows:

• Linux:

Manual Cursor Configuration

1. Create or edit the MCP configuration file:

2. Add the Stata MCP server configuration:

3. If the file already contains other MCP servers, just add the "stata-mcp" entry to the existing "mcpServers" object.

4. Save the file and restart Cursor.

Troubleshooting Cursor Configuration

1. Verify the MCP server is running

2. Check that the configuration file exists with the correct content

3. Try restarting Cursor

4. Ensure there are no port conflicts with other running applications

Cline MCP Configuration

1. Open your Cline MCP settings file:

2. Add the Stata MCP server configuration:

3. If the file already contains other MCP servers, just add the "stata-mcp" entry to the existing "mcpServers" object.

4. Save the file and restart VS Code.

Troubleshooting Cline Configuration

1. Verify the MCP server is running (Status bar should show "Stata")

2. Check that the configuration file exists with the correct content

3. Try restarting VS Code

4. Check the extension output panel (View > Output > Stata MCP) for any errors

Claude Desktop MCP Configuration

1. Make sure the Stata MCP extension is installed in VS Code or Cursor and currently running before attempting to configure Claude Desktop

2. Install mcp-proxy:

3. Find the path to mcp-proxy:

4. Configure Claude Desktop by editing the MCP config file:On Windows (typically at %APPDATA%\Claude Desktop\claude_desktop_config.json):On macOS (typically at ~/Library/Application Support/Claude Desktop/claude_desktop_config.json):Replace /path/to/mcp-proxy with the actual path you found in step 3.

5. Restart Claude Desktop

6. Claude Desktop will automatically discover the available Stata tools, allowing you to run Stata commands and analyze data directly from your conversations.

Note: There is an alternative way to use Stata MCP in Claude Desktop without installing this extension. See here.

Python Environment Management

• 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

1. Install UV manually:

2. Follow the Troubleshooting steps to reinstall the extension

Troubleshooting

Windows

1. Close all VS Code/Cursor windows

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

3. Remove the extension folder:

4. Install UV manually (if needed):

5. Restart your computer (recommended but optional)

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

macOS/Linux

1. Close all VS Code/Cursor windows

2. Kill any running Python processes:

3. Remove the extension folder:

4. Install UV manually (if needed):

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

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

Additional Troubleshooting Tips

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

• If you get permission errors:

• If the extension still fails to initialize:

• For persistent issues:

• 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

License

Credits