Stata MCP Server (macOS)

Stata MCP Server（macOS）

Claude Desktop と連携し、Stata の .do ファイルを管理・実行するための Model Context Protocol（MCP）サーバーです。

機能

📁 ファイル管理

• BROOK_Do_FILES: ディレクトリ内の .do ファイルの一覧を取得します
• READ_FILE**: .do ファイルを読み込みます
• WRITE_FILE**: .do ファイルを作成または上書きします（自動バックアップに対応）

✏️ ファイルの編集

• EDIT_FILE**: .do ファイルの特定のセクションを編集します
  • 変数を追加する（add_variable）
  • 分析コードを追加する（add_analysis）
  • カスタムセクションを挿入する（insert_section）

🚀 自動化。

• generate_do_template**: AI を使用して .do ファイルのテンプレートを生成します
• run_do_file**: Stata で .do ファイルを実行します（macOS に対応）
• run_do_selected_lines**: 選択した行のみを実行します ⭐ NEW!

インストール完了 ✅

以下の設定でインストールが完了しています。

• プロジェクトパス: /users/username/projects/stata-mcp-server
• Stata のパス: /Applications/Stata/StataBE.app/Contents/MacOS/StataBE
• 作業ディレクトリ**: /Users/username/Documents/Stata
• Cloud Desktop の設定**: /Users/username/Library/Application Support/Claude/claude_desktop_config.json

使い方。

1. Claude Desktop を再起動する

Claude Desktop を完全に終了してから、再起動します。

2. Claude Desktop で有効にする

"Read the test.do file and show me"

"Create a do file that analyzes the relationship between education and income"

"Show me a list of all do files in the current directory"

"Add a logistic regression to the analysis.do file"

"Run only lines 10 through 15 of the test_sample.do file"

"Run only the regression part of the regression.do file separately"

3. 選択した行を実行する ⭐

.do ファイル内の特定の行のみを選択して実行できるようになりました。

"Run only lines 5 through 10 of the analysis.do file"
"Run only the data load part (lines 8-12) to test"

この機能は次のように動作します。

1. 指定された行の範囲を抽出します
2. 一時的な .do ファイルを作成します（必要な設定を自動的に追加します）
3. Stata で一時ファイルを実行します
4. 結果を返した後、一時ファイルを削除します

.do ファイルのテンプレート構成。

/*******************************************************************************
* Project: [Analysis Description]
* Created: [Current Date]
* Author: Stata MCP Server (LLM generation)]
* Purpose: [Analysis Purpose] [Analysis Purpose
*******************************************************************************/

* Initial Setup
Clear all
More settings
Close capture logs
Log using "logfile.log", replace

* Load data
* Use "your_data.dta", clear

* Verify data
描述
summarize

* Create and preprocess variables
* generate new_var = .

* descriptive statistics
* tabulate var1

* main analysis
* regress Y X1 X2 X3

* save results
"results.doc" with * outreg2, replace

Close the log
exit

テスト

サーバーが正常に動作していることを確認します。

cd /users/username/projects/stata-mcp-server
echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | node dist/index.js

バックアップシステム

• ファイルの変更時に自動バックアップを作成します
• バックアップ先: $STATA_WORKSPACE/.stata-backups/
• 形式: ファイル名: filename.do.YYYY-MM-DDTHH-MM-SS-sssZ.bak

トラブルシューティング

よくある問題

1. Cloud Desktop に認識されない 1.

   • Cloud Desktop を完全に再起動します
   • 設定ファイルのパスを確認します: /users/username/library/application support/Claude/claude_desktop_config.json

2. **Stata が実行されない

   • Stata のパスを確認します: /Applications/Stata/StataBE.app/Contents/MacOS/StataBE
   • Stata のライセンスを確認します

3. **権限エラー

   • Documents/Stata ディレクトリの権限を確認します
   • ファイルの読み取り／書き込み権限を確認します

ログを確認する

# Server logs
cd /users/username/project/stata-mcp-server
node dist/index.js 2> server.log

# Stata execution log
# .log files are generated with each .do file

開発

スクリプト

npm run build # compile typescript
npm run dev # Development mode (watch)
npm run start # Start the server
npm run clean # Clean build files

環境変数

• STATA_PATH**: Stata の実行ファイルのパス
• STATA_WORKSPACE**: Stata の作業ディレクトリ

ライセンス

MIT ライセンス。

---.

**科学社会学研究チームが作成しました ❤️ ** **

Stata MCP サーバーのインストールが完了しました！ 🎉 。

Claude desktop を再起動して、試してみてください。