Stata MCP Server

VS Codeとカーソル用のStata MCP拡張機能

この拡張機能は、モデルコンテキストプロトコル（MCP）を使用してVisual Studio CodeおよびCursor IDEにStataを統合します。この拡張機能により、以下のことが可能になります。

• VS Codeまたはカーソルから直接Stataコマンドを実行する
• 選択範囲または.doファイル全体を実行する
• Stataの出力をエディターでリアルタイムに表示する
• MCPプロトコルを介してAIアシスタントを統合
• Cursor または Cline で強化された AI コーディングを体験

特徴

• Stata コマンドの実行: 選択した部分または .do ファイル全体をエディターから直接実行します
• 構文の強調表示: Stata .do、.ado、.mata、および .doh ファイルの完全な構文サポート
• AIアシスタント統合:MCP経由のコンテキストヘルプとコード提案
• クロスプラットフォーム: Windows、macOS、Linuxで動作
• 自動Stata検出:Stataのインストールを自動的に検出します
• リアルタイム出力: Stata の結果をエディターで即座に確認

デモ

この拡張機能がカーソル (または VS コード) と AI アシスタンスを使用して Stata ワークフローをどのように強化するかをご覧ください。

🎬 フルビデオバージョン| 📄 生成されたPDFレポートを表示

デモプロンプト: 「Stata doファイルを作成し、実行します。すべてのケースで完全な絶対ファイルパスが使用されていることを確認してください。自動データセット（webuse auto）を読み込み、各変数の要約統計を生成します。データセットから主要な特徴を特定して抽出し、関連するプロットを作成してplotsというフォルダに保存します。回帰分析を実施して、自動車価格の主な決定要因を調べます。すべての出力をLaTeXファイルにエクスポートし、コンパイルします。コンパイルエラーを自動的に修正し、LaTeXコンパイルが10秒を超えないようにします。すべてのコードエラーは、ワークフローの一部として特定され、解決される必要があります。」

他の Stata 統合をお探しですか?

• Notepad++とSublime Text 3でStataを使うには？こちらをご覧ください
• この拡張機能をインストールせずにClaude DesktopでStata MCPを使用するには？こちらをご覧ください
• Jupyter 経由で Stata を使用しますか?ここを参照

要件

• マシンにStata 17以降がインストールされている
• UVパッケージ マネージャー (自動的にインストールされるか、必要に応じて手動でインストールできます)

インストール

**注:**初回インストールでは依存関係の設定が必要となり、完了までに最大2分ほどかかる場合があります。この初回セットアッププロセス中はしばらくお待ちください。その後の実行はすぐに開始されます。

VSコードのインストール

オプション 1: VS Code マーケットプレイスから

この拡張機能をVS Code Marketplaceから直接インストールします。

または：

1. VSコードを開く
2. 拡張機能ビューに移動する（Ctrl+Shift+X）
3. 「Stata MCP」を検索
4. 「インストール」をクリック

オプション2: .vsixファイルから

1. リリース ページから拡張パッケージstata-mcp-0.2.1.vsixをダウンロードします。
2. 次のいずれかの方法でインストールします。

または：

1. VSコードを開く
2. 拡張機能ビューに移動する（Ctrl+Shift+X）
3. 右上の「…」メニューをクリックします
4. 「VSIX からインストール...」を選択します
5. ダウンロードした.vsixファイルに移動して選択します

カーソルのインストール

1. リリース ページから拡張パッケージstata-mcp-0.2.2.vsixをダウンロードします。
2. 次のいずれかの方法でインストールします。

または：

1. オープンカーソル
2. 拡張機能ビューに移動
3. 「…」メニューをクリックします
4. 「VSIXからインストール」を選択します
5. ダウンロードした.vsixファイルに移動して選択します

バージョン0.1.8以降、拡張機能には環境設定用の高速Pythonパッケージインストーラーuvが統合されています。システム上にuvが見つからない場合、拡張機能は自動的にインストールを試みます。

拡張機能の設定

VS Code 設定を通じて拡張機能の動作をカスタマイズできます。

• stata-vscode.stataPath : Stataインストールディレクトリへのパス
• 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.clineConfigPath : Cline 構成ファイルへのカスタム パス (オプション、デフォルトは標準の場所)
• stata-vscode.runFileTimeout : 「ファイルの実行」操作のタイムアウト（秒）（デフォルト: 600秒/10分）

使用法

1. Stata .doファイルを開く
2. 次を使用してコマンドを実行します。
   • 選択範囲を実行: Stata コードを選択し、 Ctrl+Shift+Enter (Mac の場合はCmd+Shift+Enter ) を押します。
   • ファイル実行: Ctrl+Shift+D (Macの場合はCmd+Shift+D )を押して、.doファイル全体を実行します。
3. エディターパネルで出力を表示する

仕組み

この拡張機能は、エディターを Stata に接続するローカル MCP サーバーを作成し、次のことを可能にします。

1. コマンド実行: Stataコマンドを実行し、結果を即座に確認します
2. コンテキスト認識: AIアシスタントがStataデータとコマンドを理解します
3. 生産性の向上: インテリジェントなコード提案とドキュメントの取得

カーソルMCP構成

拡張機能はカーソルMCPの統合を自動的に構成します。動作を確認するには、以下の手順に従ってください。

1. オープンカーソル
2. Ctrl+Shift+P (Macの場合はCmd+Shift+P )を押してコマンドパレットを開きます。
3. 「Stata: MCPサーバー接続のテスト」と入力してEnterキーを押します。
4. サーバーが正しく接続されていれば成功メッセージが表示されます。

カーソル設定ファイルのパス

カーソル MCP 構成ファイルの場所は、オペレーティング システムによって異なります。

• macOS :
  • 主な場所: ~/.cursor/mcp.json
  • 代替の場所: ~/Library/Application Support/Cursor/User/mcp.json
• ウィンドウズ:
  • 主な場所: %USERPROFILE%\.cursor\mcp.json
  • 代替の場所: %APPDATA%\Cursor\User\mcp.json
• リナックス:
  • 主な場所: ~/.cursor/mcp.json
  • 代替の場所: ~/.config/Cursor/User/mcp.json

手動カーソル設定

カーソル MCP を手動で構成する必要がある場合:

1. MCP 構成ファイルを作成または編集します。
   • macOS/Linux : ~/.cursor/mcp.json
   • Windows : %USERPROFILE%\.cursor\mcp.json
2. Stata MCP サーバー構成を追加します。
   { "mcpServers": { "stata-mcp": { "url": "http://localhost:4000/mcp", "transport": "sse" } } }
3. ファイルにすでに他の MCP サーバーが含まれている場合は、既存の"mcpServers"オブジェクトに"stata-mcp"エントリを追加するだけです。
4. ファイルを保存して、カーソルを再起動します。

カーソル設定のトラブルシューティング

カーソルが Stata MCP サーバーを認識しない場合:

1. MCPサーバーが実行中であることを確認する
2. 正しい内容の設定ファイルが存在するか確認する
3. カーソルを再起動してみてください
4. 実行中の他のアプリケーションとのポート競合がないことを確認する

Cline MCP構成

1. Cline MCP 設定ファイルを開きます。
   • 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. Stata MCP サーバー構成を追加します。
   { "mcpServers": { "stata-mcp": { "url": "http://localhost:4000/mcp", "transport": "sse" } } }
3. ファイルにすでに他の MCP サーバーが含まれている場合は、既存の"mcpServers"オブジェクトに"stata-mcp"エントリを追加するだけです。
4. ファイルを保存して VS Code を再起動します。

VS Code 設定を通じて Cline を構成することもできます。

Cline 構成のトラブルシューティング

Cline が Stata MCP サーバーを認識しない場合:

1. MCP サーバーが実行中であることを確認します (ステータス バーに「Stata」と表示されます)
2. 正しい内容の設定ファイルが存在するか確認する
3. VS Codeを再起動してみてください
4. 拡張機能の出力パネル（表示 > 出力 > Stata MCP）でエラーがないか確認します。

クロードデスクトップMCP構成

この拡張機能は、mcp-proxy を介して Claude Desktop で使用できます。

1. Claude Desktop を構成する前に、Stata MCP 拡張機能が VS Code または Cursor にインストールされ、現在実行されていることを確認してください。
2. mcp-proxy をインストールします。
   # Using pip pip install mcp-proxy # Or using uv (faster) uv install mcp-proxy
3. mcp-proxy へのパスを見つけます:
   # On Mac/Linux which mcp-proxy # On Windows (PowerShell) (Get-Command mcp-proxy).Path
4. MCP 構成ファイルを編集して Claude Desktop を構成します。Windows の場合(通常は%APPDATA%\Claude Desktop\claude_desktop_config.jsonにあります):
   { "mcpServers": { "stata-mcp": { "command": "mcp-proxy", "args": ["http://127.0.0.1:4000/mcp"] } } }
   macOS の場合(通常は~/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"] } } }
   /path/to/mcp-proxyを、手順 3 で確認した実際のパスに置き換えます。
5. Claudeデスクトップを再起動します
6. Claude Desktop は利用可能な Stata ツールを自動的に検出し、会話から直接 Stata コマンドを実行してデータを分析できるようにします。

**注：**この拡張機能をインストールせずに、Claude DesktopでStata MCPを使用する別の方法があります。こちらをご覧ください。

Python 環境管理

この拡張機能は、Rust で構築された高速 Python パッケージインストーラーであるuvを使用して、Python の依存関係を管理します。主な機能:

• 自動Pythonセットアップと依存関係管理
• システムと競合しない隔離された環境を作成します
• Windows、macOS、Linuxで動作
• 従来のpipインストールよりも10～100倍高速

インストール中に UV 関連のエラーが発生した場合:

1. UVを手動でインストールします:
   # 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. トラブルシューティングの手順に従って拡張機能を再インストールしてください

バージョン0.1.8以降、この拡張機能は環境設定のために高速Pythonパッケージインストーラーuv を統合します。システム上に uv が見つからない場合、拡張機能は自動的にインストールを試みます。

トラブルシューティング

拡張機能で問題が発生した場合は、次の手順に従ってクリーンな再インストールを実行してください。

ウィンドウズ

1. すべてのVS Code/カーソルウィンドウを閉じる
2. タスク マネージャーを開きます (Ctrl+Shift+Esc):
   • 「プロセス」タブに移動します
   • 実行中のPythonまたはuvicornプロセスを探す
   • それぞれ選択して「タスクの終了」をクリックします
3. 拡張機能フォルダを削除します。
   • Win+Rを押して、 %USERPROFILE%\.vscode\extensionsと入力し、Enterを押します。
   • deepecon.stata-mcp-0.xxフォルダを削除します（xx はバージョン番号です）。
   • カーソルの場合: パスは%USERPROFILE%\.cursor\extensions
4. UV を手動でインストールします (必要な場合):
   # Open PowerShell as Administrator and run: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
5. コンピュータを再起動します（推奨ですがオプションです）
6. マーケットプレイスから最新バージョンの拡張機能をインストールします

macOS/Linux

1. すべてのVS Code/カーソルウィンドウを閉じる
2. 実行中の Python プロセスをすべて終了します。
   # Find Python processes ps aux | grep python # Kill them (replace <PID> with the process numbers you found) kill -9 <PID>
3. 拡張機能フォルダを削除します。
   # 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. UV を手動でインストールします (必要な場合):
   # Using curl: curl -LsSf https://astral.sh/uv/install.sh | sh # Or using 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. 出力パネルを開く（表示 -> 出力）
  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 で問題を開くときは、以下を提供してください。

• 出力パネルからの完全なエラーメッセージ（表示 -> 出力 -> Stata-MCP）
• お使いのオペレーティングシステムとバージョン
• VS Code/カーソルバージョン
• Python バージョン ( python --version )
• UV バージョン ( uv --version )
• 問題を再現する手順
• 関連するログファイルまたはスクリーンショット
• MCP 構成ファイルの内容（該当する場合）

この詳細な情報は、問題をより迅速に特定し解決するために役立ちます。GitHub Issuesで問題を報告できます。

ライセンス

マサチューセッツ工科大学

クレジット

作成者：Lu Han 発行者：DeepEcon