Stata MCP Server

Ein MCP-Server, der die Stata-GUI über Windows Stata Automation COM für Claude Code steuerbar macht.

• 中文

• English

中文

功能

• Durch Stata Automation COM Befehle in einem echten Stata-GUI-Fenster ausführen.

• Stata-Sitzungen anhand des absoluten Pfads der Do-Files verwalten: Dasselbe Do-File verwendet dasselbe Stata-Fenster wieder.

• Verschiedene Do-Files öffnen verschiedene Stata-Fenster, was das gleichzeitige Betrachten mehrerer Analyseaufgaben erleichtert.

• Befehle ohne Pfadangabe werden an die zuletzt ausgeführte Do-File-Sitzung gesendet.

• Unterstützt das Schreiben, Lesen, Anhängen und Ausführen von Do-Files.

• Unterstützt das Lesen von Stata-Text-Logs, damit Claude die Ergebnisse analysieren kann.

• Unterstützt das Lesen der aktuellen Datenstruktur, fehlender Werte und einer Stichprobenvorschau, um Claude bei der Bearbeitung von Do-Files zu unterstützen.

Demo

Verzeichnisstruktur

D:/Stata18/mcp/
├── README.md
├── pyproject.toml
├── .gitignore
├── stata_mcp.py              # 兼容启动器
├── src/
│   └── stata_mcp/
│       ├── __init__.py
│       └── server.py         # MCP 服务器主文件
├── runtime/
│   ├── dofiles/              # Claude/MCP 默认生成 do 文件
│   └── logs/                 # Claude/MCP 默认读取或生成 log
└── examples/                 # 示例 do 文件

Systemanforderungen

• Windows

• Stata 18 MP, mit registriertem Automation COM

• Python 3.10+

• Python-Pakete: mcp, pywin32

• Claude Code

Empfohlener Installationsort

Es wird empfohlen, dieses Projekt im mcp-Ordner des Stata-Installationsverzeichnisses abzulegen, zum Beispiel:

D:/Stata18/mcp

Falls Stata an einem anderen Ort installiert ist, wird ebenfalls empfohlen, es im entsprechenden Verzeichnis abzulegen, zum Beispiel:

C:/Program Files/Stata18/mcp

Fortgeschrittene Benutzer können es auch in einem beliebigen stabilen Verzeichnis ablegen. Unabhängig vom Speicherort muss der Skriptpfad in der Claude Code MCP-Konfiguration auf die tatsächliche stata_mcp.py zeigen.

Installationsschritte

1. Laden Sie dieses Repository herunter oder klonen Sie es in den mcp-Ordner im Stata-Installationsverzeichnis.

2. Installieren Sie die Python-Abhängigkeiten:

pip install mcp pywin32

Alternativ können Sie diese auch in einer virtuellen Umgebung installieren:

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install mcp pywin32

3. Öffnen Sie PowerShell als Administrator und registrieren Sie Stata Automation. Passen Sie den Befehl an Ihren Stata-Installationspfad an:

Start-Process -FilePath "D:\Stata18\StataMP-64.exe" -ArgumentList "/Register" -Wait

4. Überprüfen Sie, ob COM verfügbar ist:

python -c "import win32com.client; s=win32com.client.Dispatch('stata.StataOLEApp'); s.DoCommand('display 12345')"

Erwartetes Ergebnis: Die Stata-GUI öffnet sich oder wird verbunden und zeigt 12345 an.

Zu Claude Code hinzufügen (empfohlen)

Es wird empfohlen, claude mcp add zu verwenden:

claude mcp add stata -- python D:\Stata18\mcp\stata_mcp.py

Falls die Installation in einem anderen Pfad erfolgte, ersetzen Sie diesen durch den tatsächlichen Pfad. Zum Beispiel:

claude mcp add stata -- python "C:\Program Files\Stata18\mcp\stata_mcp.py"

Starten Sie nach dem Hinzufügen Claude Code neu und bestätigen Sie, dass das stata-Tool in der Liste der MCP-Tools erscheint.

Manuelle Konfiguration von Claude Code MCP

Falls Sie claude mcp add nicht verwenden, können Sie die MCP-JSON auch manuell konfigurieren:

"stata": {
  "command": "python",
  "args": ["D:\\Stata18\\mcp\\stata_mcp.py"]
}

Sie können auch direkt auf die Hauptdatei verweisen:

"stata": {
  "command": "python",
  "args": ["D:\\Stata18\\mcp\\src\\stata_mcp\\server.py"]
}

Normalerweise wird die Verwendung des Kompatibilitäts-Launchers stata_mcp.py empfohlen, da die Konfiguration bei späteren Änderungen der internen Projektstruktur stabiler bleibt.

Konfigurierbare Umgebungsvariablen

Für normale Benutzer ist keine Einstellung erforderlich. Falls Ihr Installationspfad oder COM-Name besonders ist, können Sie Folgendes festlegen:

Tools

Regeln für Do-Files und Sitzungen

• stata_run_dofile(path) verwendet den absoluten Pfad des Do-Files als Sitzungskennung.

• Derselbe Do-File-Pfad verwendet dasselbe Stata-Fenster wieder.

• Verschiedene Do-File-Pfade erstellen verschiedene Stata-Fenster.

• stata_run, stata_get_results, stata_get_data_info, stata_get_data_schema werden standardmäßig an die zuletzt ausgeführte Do-File-Sitzung gesendet.

• Wenn noch kein Do-File ausgeführt wurde, fordern Befehle ohne Pfad dazu auf, zuerst ein Do-File auszuführen.

Lesen der aktuellen Datenstruktur und Stichproben

stata_get_data_schema generiert einen Text-Log-Snapshot in der letzten Do-File-Sitzung und gibt den Inhalt an Claude zurück. Standardmäßig enthalten:

• describe

• codebook, compact

• misstable summarize

• list in 1/20, abbreviate(20)

• notes

• label dir

Optionale Parameter:

Dies ermöglicht es Claude, nicht nur Variablennamen, Typen und Labels zu sehen, sondern auch eine kleine Menge echter Daten, um die Bearbeitung von Do-Files präziser zu unterstützen.

Log-Strategie

• stata_get_data_schema überschreibt seinen eigenen Schema-Snapshot-Log, da dieser die aktuelle Datenstruktur repräsentiert.

• Wenn Claude andere Analyseergebnisse lesen soll, sollte Stata ein Text-Log schreiben, das dann mit stata_read_log gelesen wird.

• Empfohlene Regel: Innerhalb derselben Claude/MCP-Sitzung anhängen; beim ersten Ausführen desselben Do-Files in einer neuen Sitzung überschreiben, um ein unendliches Anwachsen der Logs zu vermeiden.

Fehlerbehebung

pywin32 nicht verfügbar

Führen Sie aus:

pip install pywin32

COM kann keine Stata-Instanz erstellen

Registrieren Sie Stata Automation erneut:

Start-Process -FilePath "D:\Stata18\StataMP-64.exe" -ArgumentList "/Register" -Wait

Führen Sie den Befehl mit /Register nicht direkt in Git Bash aus, da Git Bash /Register möglicherweise in einen Pfad umschreibt.

stata_run meldet, dass keine Do-File-Sitzung existiert

Führen Sie zuerst ein Do-File aus:

stata_run_dofile(path="D:/Stata18/mcp/examples/browse_test.do")

Danach werden Befehle ohne Pfad an diese letzte Sitzung gesendet.

Claude kann die Ergebnisse der Stata-GUI nicht direkt sehen

Claude kann den Bildschirminhalt nicht lesen. Sie müssen Stata anweisen, ein Text-Log zu schreiben, das dann über stata_read_log gelesen wird; oder verwenden Sie stata_get_data_schema, um einen Snapshot der aktuellen Datenstruktur zu erhalten.

Related MCP server: Windows-MCP

English

Features

• Runs Stata commands in the real Stata GUI through Stata Automation COM.

• Keeps one Stata session per absolute do-file path: the same do file reuses the same Stata window.

• Different do files open different Stata windows, so multiple analysis tasks can stay visible.

• Pathless commands are sent to the most recently used do-file session.

• Supports writing, reading, appending, and running do files.

• Supports reading Stata text logs so Claude can analyze command output.

• Supports reading the current data structure, missing-value summary, and sample rows to help Claude edit do files.

Project layout

D:/Stata18/mcp/
├── README.md
├── pyproject.toml
├── .gitignore
├── stata_mcp.py              # compatibility launcher
├── src/
│   └── stata_mcp/
│       ├── __init__.py
│       └── server.py         # main MCP server
├── runtime/
│   ├── dofiles/              # default do files generated by Claude/MCP
│   └── logs/                 # default logs generated or read by Claude/MCP
└── examples/                 # example do files

Requirements

• Windows

• Stata 18 MP with Automation COM registered

• Python 3.10+

• Python packages: mcp, pywin32

• Claude Code

Recommended install location

It is recommended to place this project inside your Stata installation directory, for example:

D:/Stata18/mcp

If Stata is installed somewhere else, place the project under that Stata directory, for example:

C:/Program Files/Stata18/mcp

Advanced users may place it in any stable directory. Wherever you install it, the Claude Code MCP configuration must point to the actual stata_mcp.py path.

Installation

1. Download or clone this repository into the mcp folder under your Stata installation directory.

2. Install Python dependencies:

pip install mcp pywin32

You may also use a virtual environment:

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install mcp pywin32

3. Open PowerShell as Administrator, then register Stata Automation. Adjust the path to your Stata installation:

Start-Process -FilePath "D:\Stata18\StataMP-64.exe" -ArgumentList "/Register" -Wait

4. Verify COM:

python -c "import win32com.client; s=win32com.client.Dispatch('stata.StataOLEApp'); s.DoCommand('display 12345')"

Expected result: the Stata GUI opens or is connected, and displays 12345.

Add to Claude Code (recommended)

Use claude mcp add:

claude mcp add stata -- python D:\Stata18\mcp\stata_mcp.py

If you installed the project somewhere else, replace the path with your actual path. Example:

claude mcp add stata -- python "C:\Program Files\Stata18\mcp\stata_mcp.py"

Restart Claude Code after adding the MCP server, then confirm that the stata tools are available.

Manual Claude Code MCP configuration

If you do not use claude mcp add, you can configure MCP manually with JSON:

"stata": {
  "command": "python",
  "args": ["D:\\Stata18\\mcp\\stata_mcp.py"]
}

You can also point directly to the main server file:

"stata": {
  "command": "python",
  "args": ["D:\\Stata18\\mcp\\src\\stata_mcp\\server.py"]
}

The compatibility launcher stata_mcp.py is usually recommended because it keeps your Claude Code configuration stable if the internal project layout changes later.

Environment variables

Most users do not need these. If your installation path or COM ProgID is unusual, you can configure:

Tools

Do-file and session rules

• stata_run_dofile(path) uses the absolute do-file path as the session key.

• The same do-file path reuses the same Stata window.

• Different do-file paths create different Stata windows.

• stata_run, stata_get_results, stata_get_data_info, and stata_get_data_schema are sent to the most recent do-file session by default.

• If no do file has been run yet, pathless commands will ask you to run a do file first.

Reading current data structure and sample rows

stata_get_data_schema creates a text log snapshot in the most recent do-file session and returns it to Claude. By default, it includes:

• describe

• codebook, compact

• misstable summarize

• list in 1/20, abbreviate(20)

• notes

• label dir

Options:

This lets Claude see not only variable names, types, and labels, but also a small real-data sample, which helps it write better Stata code.

Log strategy

• stata_get_data_schema overwrites its own schema snapshot log because it represents the current data state.

• For other analysis output, ask Stata to write a text log, then use stata_read_log to read it.

• Recommended rule: append within the same Claude/MCP session; overwrite the first time the same do file is run in a new session, so logs do not grow forever.

Troubleshooting

pywin32 is unavailable

Run:

pip install pywin32

COM cannot create a Stata instance

Register Stata Automation again:

Start-Process -FilePath "D:\Stata18\StataMP-64.exe" -ArgumentList "/Register" -Wait

Do not run the /Register command directly in Git Bash, because Git Bash may rewrite /Register as a path.

stata_run says there is no do-file session

Run a do file first:

stata_run_dofile(path="D:/Stata18/mcp/examples/browse_test.do")

After that, pathless commands are sent to the most recent session.

Claude cannot directly see Stata GUI output

Claude cannot read screen contents directly. To let Claude analyze Stata output, write a Stata text log and read it with stata_read_log; or use stata_get_data_schema for a current data snapshot.