Stata MCP Server

Stata MCP-Erweiterung für VS Code und Cursor

Diese Erweiterung ermöglicht die Stata-Integration für Visual Studio Code und Cursor IDE mithilfe des Model Context Protocol (MCP). Die Erweiterung ermöglicht Ihnen:

• Führen Sie Stata-Befehle direkt aus VS Code oder Cursor aus
• Auswahlen oder ganze .do-Dateien ausführen
• Stata-Ausgabe im Editor in Echtzeit anzeigen
• Holen Sie sich die Integration des KI-Assistenten über das MCP-Protokoll
• Erleben Sie verbesserte KI-Codierung mit Cursor oder Cline
• Wählen Sie Ihre Stata-Edition (MP, SE oder IC)

Merkmale

• Stata-Befehle ausführen : Führen Sie Auswahlen oder ganze .do-Dateien direkt aus Ihrem Editor aus
• Syntaxhervorhebung : Vollständige Syntaxunterstützung für Stata-Dateien mit den Erweiterungen .do, .ado, .mata und .doh
• Integration des KI-Assistenten : Kontextbezogene Hilfe und Codevorschläge über MCP
• Plattformübergreifend : Funktioniert unter Windows, macOS und Linux
• Automatische Stata-Erkennung : Findet automatisch Ihre Stata-Installation
• Echtzeitausgabe : Sehen Sie Stata-Ergebnisse sofort in Ihrem Editor

Demo

Sehen Sie, wie diese Erweiterung Ihren Stata-Workflow mit Cursor- (oder VS Code-) und KI-Unterstützung verbessert:

🎬 Vollständige Videoversion | 📄 Generierten PDF-Bericht anzeigen

Demo-Eingabeaufforderung: „Schreiben und führen Sie Stata-Do-Dateien aus und stellen Sie sicher, dass stets die vollständigen absoluten Dateipfade verwendet werden. Laden Sie den Auto-Datensatz (webuse auto) und generieren Sie zusammenfassende Statistiken für jede Variable. Identifizieren und extrahieren Sie wichtige Merkmale aus dem Datensatz, erstellen Sie relevante Diagramme und speichern Sie diese in einem Ordner mit dem Namen „plots“. Führen Sie eine Regressionsanalyse durch, um die wichtigsten Einflussfaktoren auf die Autopreise zu untersuchen. Exportieren Sie alle Ausgaben in eine LaTeX-Datei und kompilieren Sie diese. Beheben Sie Kompilierungsfehler automatisch und stellen Sie sicher, dass die LaTeX-Kompilierung nicht länger als 10 Sekunden dauert. Alle Codefehler sollten im Rahmen des Workflows identifiziert und behoben werden.“

Suchen Sie nach anderen Stata-Integrationen?

• Stata mit Notepad++ und Sublime Text 3 verwenden? Siehe hier
• Stata MCP in Claude Desktop verwenden, ohne diese Erweiterung zu installieren? Siehe hier
• Stata über Jupyter nutzen? Siehe hier

Anforderungen

• Stata 17 oder höher auf Ihrem Computer installiert
• UV -Paketmanager (wird automatisch installiert oder kann bei Bedarf manuell installiert werden)

Installation

Hinweis: Für die Erstinstallation müssen Abhängigkeiten eingerichtet werden. Dies kann bis zu zwei Minuten dauern. Bitte haben Sie während dieses einmaligen Einrichtungsvorgangs etwas Geduld. Alle nachfolgenden Ausführungen werden sofort gestartet.

VS Code-Installation

Option 1: Vom VS Code Marketplace

Installieren Sie diese Erweiterung direkt vom VS Code Marketplace .

Oder:

1. Öffnen Sie VS Code
2. Zur Erweiterungsansicht wechseln (Strg+Umschalt+X)
3. Suche nach „Stata MCP“
4. Klicken Sie auf „Installieren“

Option 2: Aus einer VSIX-Datei

1. Laden Sie das Erweiterungspaket stata-mcp-0.2.3.vsix von der Release-Seite herunter.
2. Installieren Sie es mit einer der folgenden Methoden:

Oder:

1. Öffnen Sie VS Code
2. Zur Erweiterungsansicht wechseln (Strg+Umschalt+X)
3. Klicken Sie oben rechts auf das Menü "..."
4. Wählen Sie „Von VSIX installieren …“
5. Navigieren Sie zur heruntergeladenen VSIX-Datei und wählen Sie sie aus.

Cursorinstallation

1. Laden Sie das Erweiterungspaket stata-mcp-0.2.3.vsix von der Release-Seite herunter.
2. Installieren Sie es mit einer der folgenden Methoden:

Oder:

1. Cursor öffnen
2. Zur Erweiterungsansicht wechseln
3. Klicken Sie auf das Menü "..."
4. Wählen Sie „Von VSIX installieren“
5. Navigieren Sie zur heruntergeladenen VSIX-Datei und wählen Sie sie aus.

Ab Version 0.1.8 integriert die Erweiterung einen schnellen Python-Paketinstaller namens uv zur Einrichtung der Umgebung. Sollte uv auf Ihrem System nicht gefunden werden, versucht die Erweiterung, es automatisch zu installieren.

Erweiterungseinstellungen

Sie können das Verhalten der Erweiterung über die VS Code-Einstellungen anpassen:

• stata-vscode.stataPath : Pfad zum Stata-Installationsverzeichnis
• stata-vscode.mcpServerHost : Host für MCP-Server (Standard: localhost)
• stata-vscode.mcpServerPort : Port für den MCP-Server (Standard: 4000)
• stata-vscode.autoStartServer : MCP-Server automatisch starten, wenn Erweiterung aktiviert wird (Standard: true)
• stata-vscode.debugMode : Detaillierte Debug-Informationen im Ausgabefenster anzeigen (Standard: false)
• stata-vscode.forcePort : Erzwingt, dass der MCP-Server den angegebenen Port verwendet, auch wenn dieser bereits verwendet wird (Standard: „false“).
• stata-vscode.clineConfigPath : Benutzerdefinierter Pfad zur Cline-Konfigurationsdatei (optional, standardmäßig auf Standardspeicherorte eingestellt)
• stata-vscode.runFileTimeout : Timeout in Sekunden für „Datei ausführen“-Vorgänge (Standard: 600 Sekunden/10 Minuten)
• stata-vscode.stataEdition : Zu verwendende Stata-Edition (MP, SE, IC) – Standard: MP

Verwendung

1. Öffnen Sie eine Stata-.do-Datei
2. Führen Sie Befehle aus mit:
   • Auswahl ausführen : Wählen Sie Stata-Code aus und drücken Sie Ctrl+Shift+Enter (oder Cmd+Shift+Enter auf dem Mac).
   • Datei ausführen : Drücken Sie Ctrl+Shift+D (oder Cmd+Shift+D auf dem Mac), um die gesamte DO-Datei auszuführen
3. Ausgabe im Editorbereich anzeigen
4. Stata-Edition auswählen : Wählen Sie in den Erweiterungseinstellungen Ihre bevorzugte Stata-Edition (MP, SE oder IC) aus.

Wie es funktioniert

Die Erweiterung erstellt einen lokalen MCP-Server, der Ihren Editor mit Stata verbindet und Folgendes ermöglicht:

1. Befehlsausführung : Führen Sie Stata-Befehle aus und sehen Sie sofort die Ergebnisse
2. Kontextbewusstsein : KI-Assistenten verstehen Ihre Stata-Daten und -Befehle
3. Verbesserte Produktivität : Erhalten Sie intelligente Codevorschläge und Dokumentation

Cursor-MCP-Konfiguration

Die Erweiterung konfiguriert die Cursor-MCP-Integration automatisch. So überprüfen Sie die Funktion:

1. Cursor öffnen
2. Drücken Sie Ctrl+Shift+P (oder Cmd+Shift+P auf dem Mac), um die Befehlspalette zu öffnen
3. Geben Sie „Stata: Test MCP Server Connection“ ein und drücken Sie die Eingabetaste
4. Wenn die Verbindung zum Server ordnungsgemäß hergestellt ist, sollte eine Erfolgsmeldung angezeigt werden.

Cursor-Konfigurationsdateipfade

Der Speicherort der Cursor MCP-Konfigurationsdateien variiert je nach Betriebssystem:

• macOS :
  • Primärer Speicherort: ~/.cursor/mcp.json
  • Alternativer Speicherort: ~/Library/Application Support/Cursor/User/mcp.json
• Windows :
  • Primärer Speicherort: %USERPROFILE%\.cursor\mcp.json
  • Alternativer Speicherort: %APPDATA%\Cursor\User\mcp.json
• Linux :
  • Primärer Speicherort: ~/.cursor/mcp.json
  • Alternativer Speicherort: ~/.config/Cursor/User/mcp.json

Manuelle Cursorkonfiguration

Wenn Sie Cursor MCP manuell konfigurieren müssen:

1. Erstellen oder bearbeiten Sie die MCP-Konfigurationsdatei:
   • macOS/Linux : ~/.cursor/mcp.json
   • Windows : %USERPROFILE%\.cursor\mcp.json
2. Fügen Sie die Stata MCP-Serverkonfiguration hinzu:
   { "mcpServers": { "stata-mcp": { "url": "http://localhost:4000/mcp", "transport": "sse" } } }
3. Wenn die Datei bereits andere MCP-Server enthält, fügen Sie einfach den Eintrag "stata-mcp" zum vorhandenen Objekt "mcpServers" hinzu.
4. Speichern Sie die Datei und starten Sie Cursor neu.

Fehlerbehebung bei der Cursorkonfiguration

Wenn Cursor den Stata MCP-Server nicht erkennt:

1. Überprüfen Sie, ob der MCP-Server ausgeführt wird
2. Überprüfen Sie, ob die Konfigurationsdatei mit dem richtigen Inhalt vorhanden ist
3. Versuchen Sie, Cursor neu zu starten
4. Stellen Sie sicher, dass es keine Portkonflikte mit anderen laufenden Anwendungen gibt

Cline MCP-Konfiguration

1. Öffnen Sie Ihre Cline MCP-Einstellungsdatei:
   • 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
2. Fügen Sie die Stata MCP-Serverkonfiguration hinzu:
   { "mcpServers": { "stata-mcp": { "url": "http://localhost:4000/mcp", "transport": "sse" } } }
3. Wenn die Datei bereits andere MCP-Server enthält, fügen Sie einfach den Eintrag "stata-mcp" zum vorhandenen Objekt "mcpServers" hinzu.
4. Speichern Sie die Datei und starten Sie VS Code neu.

Sie können Cline auch über die VS Code-Einstellungen konfigurieren:

Fehlerbehebung bei der Cline-Konfiguration

Wenn Cline den Stata MCP-Server nicht erkennt:

1. Überprüfen Sie, ob der MCP-Server läuft (in der Statusleiste sollte „Stata“ angezeigt werden).
2. Überprüfen Sie, ob die Konfigurationsdatei mit dem richtigen Inhalt vorhanden ist
3. Versuchen Sie, VS Code neu zu starten
4. Überprüfen Sie das Erweiterungsausgabefenster (Ansicht > Ausgabe > Stata MCP) auf Fehler

Claude Desktop MCP-Konfiguration

Sie können diese Erweiterung mit Claude Desktop über mcp-proxy verwenden:

1. Stellen Sie sicher, dass die Stata MCP-Erweiterung in VS Code oder Cursor installiert ist und aktuell ausgeführt wird, bevor Sie versuchen, Claude Desktop zu konfigurieren.
2. Installieren Sie den MCP-Proxy:
   # Using pip pip install mcp-proxy # Or using uv (faster) uv install mcp-proxy
3. Suchen Sie den Pfad zum MCP-Proxy:
   # On Mac/Linux which mcp-proxy # On Windows (PowerShell) (Get-Command mcp-proxy).Path
4. Konfigurieren Sie Claude Desktop, indem Sie die MCP-Konfigurationsdatei bearbeiten:Unter Windows (normalerweise unter %APPDATA%\Claude Desktop\claude_desktop_config.json ):
   { "mcpServers": { "stata-mcp": { "command": "mcp-proxy", "args": ["http://127.0.0.1:4000/mcp"] } } }
   Unter macOS (normalerweise unter ~/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"] } } }
   Ersetzen Sie /path/to/mcp-proxy durch den tatsächlichen Pfad, den Sie in Schritt 3 gefunden haben.
5. Starten Sie Claude Desktop neu
6. Claude Desktop erkennt automatisch die verfügbaren Stata-Tools, sodass Sie Stata-Befehle ausführen und Daten direkt aus Ihren Konversationen analysieren können.

Hinweis: Es gibt eine alternative Möglichkeit, Stata MCP in Claude Desktop zu verwenden, ohne diese Erweiterung zu installieren. Siehe hier .

Python-Umgebungsverwaltung

Diese Erweiterung verwendet uv , einen schnellen Python-Paketinstaller, der in Rust integriert ist, um Python-Abhängigkeiten zu verwalten. Wichtige Funktionen:

• Automatisches Python-Setup und Abhängigkeitsmanagement
• Erstellt isolierte Umgebungen, die nicht mit Ihrem System in Konflikt geraten
• Funktioniert unter Windows, macOS und Linux
• 10-100x schneller als herkömmliche Pip-Installationen

Wenn während der Installation UV-bezogene Fehler auftreten:

1. UV manuell installieren:
   # 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. Befolgen Sie die Schritte zur Fehlerbehebung , um die Erweiterung neu zu installieren

Ab Version 0.1.8 integriert diese Erweiterung den schnellen Python-Paketinstaller uv zur Einrichtung der Umgebung. Sollte uv auf Ihrem System nicht gefunden werden, versucht die Erweiterung, es automatisch zu installieren.

Fehlerbehebung

Wenn bei der Erweiterung Probleme auftreten, führen Sie die folgenden Schritte aus, um eine saubere Neuinstallation durchzuführen:

Windows

1. Schließen Sie alle VS Code/Cursor-Fenster
2. Öffnen Sie den Task-Manager (Strg+Umschalt+Esc):
   • Gehen Sie zur Registerkarte "Prozesse"
   • Suchen Sie nach laufenden Python- oder uvicorn -Prozessen
   • Wählen Sie jeden aus und klicken Sie auf „Task beenden“.
3. Entfernen Sie den Erweiterungsordner:
   • Drücken Sie Win+R, geben Sie %USERPROFILE%\.vscode\extensions ein und drücken Sie die Eingabetaste
   • Löschen Sie den Ordner deepecon.stata-mcp-0.xx (wobei xx die Versionsnummer ist).
   • Für Cursor: Der Pfad lautet %USERPROFILE%\.cursor\extensions
4. Installieren Sie UV manuell (falls erforderlich):
   # Open PowerShell as Administrator and run: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
5. Starten Sie Ihren Computer neu (empfohlen, aber optional)
6. Installieren Sie die neueste Version der Erweiterung vom Marktplatz

macOS/Linux

1. Schließen Sie alle VS Code/Cursor-Fenster
2. Beenden Sie alle laufenden Python-Prozesse:
   # Find Python processes ps aux | grep python # Kill them (replace <PID> with the process numbers you found) kill -9 <PID>
3. Entfernen Sie den Erweiterungsordner:
   # 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. Installieren Sie UV manuell (falls erforderlich):
   # Using curl: curl -LsSf https://astral.sh/uv/install.sh | sh # Or using wget: wget -qO- https://astral.sh/uv/install.sh | sh
5. Starten Sie Ihr Terminal oder Ihren Computer neu (empfohlen, aber optional)
6. Installieren Sie die neueste Version der Erweiterung vom Marktplatz

Zusätzliche Tipps zur Fehlerbehebung

• Wenn Sie Fehlermeldungen erhalten, dass Python oder UV nicht gefunden werden, stellen Sie sicher, dass sie sich im PATH Ihres Systems befinden:
  • Windows: Geben Sie im Startmenü "Umgebungsvariablen" ein und fügen Sie die Installationspfade hinzu
  • macOS/Linux: Fügen Sie die Pfade zu Ihrer ~/.bashrc , ~/.zshrc oder einem gleichwertigen Verzeichnis hinzu
• Wenn Sie Berechtigungsfehler erhalten:
  • Windows: Führen Sie VS Code/Cursor als Administrator aus
  • macOS/Linux: Ordnerberechtigungen mit ls -la prüfen und bei Bedarf mit chmod beheben
• Wenn die Initialisierung der Erweiterung immer noch fehlschlägt:
  1. Öffnen Sie das Ausgabefenster (Ansicht -> Ausgabe).
  2. Wählen Sie „Stata-MCP“ aus der Dropdown-Liste
  3. Überprüfen Sie die Protokolle auf bestimmte Fehlermeldungen
  4. Wenn Python-bezogene Fehler auftreten, versuchen Sie, manuell eine virtuelle Python 3.11-Umgebung zu erstellen:
     # Windows py -3.11 -m venv .venv # macOS/Linux python3.11 -m venv .venv
• Bei anhaltenden Problemen:
  1. Überprüfen Sie die Python-Installation Ihres Systems: python --version oder python3 --version
  2. Überprüfen Sie die UV-Installation: uv --version
  3. Stellen Sie sicher, dass Sie Python 3.11 oder höher installiert haben
  4. Überprüfen Sie, ob Ihre Antivirensoftware Python- oder UV-ausführbare Dateien blockiert
• Wenn Sie Probleme mit einer bestimmten Stata-Edition haben:
  1. Stellen Sie sicher, dass die ausgewählte Stata-Edition (MP, SE oder IC) mit der auf Ihrem System installierten Version übereinstimmt.
  2. Versuchen Sie, die Einstellung stata-vscode.stataEdition so zu ändern, dass sie Ihrer installierten Version entspricht
  3. Starten Sie die Erweiterung nach dem Ändern der Einstellungen neu

Wenn Sie ein Problem auf GitHub öffnen, geben Sie bitte Folgendes an:

• Die vollständige Fehlermeldung aus dem Ausgabefenster (Ansicht -> Ausgabe -> Stata-MCP)
• Ihr Betriebssystem und die Version
• VS Code/Cursor-Version
• Python-Version ( python --version )
• UV-Version ( uv --version )
• Schritte zum Reproduzieren des Problems
• Alle relevanten Protokolldateien oder Screenshots
• Der Inhalt Ihrer MCP-Konfigurationsdatei, falls zutreffend

Diese detaillierten Informationen helfen uns, das Problem schneller zu identifizieren und zu beheben. Sie können Probleme unter GitHub Issues melden.

Lizenz

MIT

Credits

Erstellt von Lu Han. Veröffentlicht von DeepEcon