Skip to main content
Glama

Stata MCP Server (macOS)

A Model Context Protocol (MCP) server for managing and running Stata .do files that integrates with Claude Desktop.

Features

๐Ÿ“ File management

  • BROOK_Do_FILES: Get a list of .do files in a directory

  • READ_FILE**: Read a .do file

  • WRITE_FILE**: Create or overwrite a .do file (supports automatic backup)

โœ๏ธ Edit a file

  • EDIT_FILE**: Edit a specific section of a .do file

    • Add a variable (add_variable)

    • Add analysis code (add_analysis)

    • Insert a custom section (insert_section)

๐Ÿš€ Automation.

  • generate_do_template**: Generate a .do file template using AI

  • run_do_file**: Run a .do file in Stata (macOS support)

  • run_do_selected_lines**: Run only selected lines โญ NEW!

Related MCP server: Universal MCP Server

Installation complete โœ…

The installation is complete with the following configuration:

  • project path: /users/username/projects/stata-mcp-server

  • Stata path: /Applications/Stata/StataBE.app/Contents/MacOS/StataBE

  • Working directory**: /Users/username/Documents/Stata

  • Cloud Desktop Settings**: /Users/username/Library/Application Support/Claude/claude_desktop_config.json

How to use it.

1. Restart Claude Desktop

Completely shut down and restart Claude Desktop.

2. Enable in 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. Run selected lines โญ

You can now select and run only certain lines of a do file:

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

This function works as follows

  1. extracts the specified line range

  2. creates a temporary .do file (automatically adding the necessary settings)

  3. run the temporary file in Stata

  4. clean up the temporary file after returning results

Do file template structure.

/*******************************************************************************
* 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

Testing

Verify that the server is working properly:

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

Backup system

  • Create automatic backups when files are modified

  • Backup location: $STATA_WORKSPACE/.stata-backups/

  • Format: Filename: filename.do.YYYY-MM-DDTHH-MM-SS-sssZ.bak

Troubleshooting

Common issues

  1. Not recognized by Cloud Desktop 1.

    • Restart Cloud Desktop completely

    • Check configuration file path: /users/username/library/application support/Claude/claude_desktop_config.json

  2. **Stata fails to run

    • Check Stata path: /Applications/Stata/StataBE.app/Contents/MacOS/StataBE

    • Check Stata license

  3. **Permissions error

    • Check Documents/Stata directory permissions

    • Check file read/write permissions

Check the log

# 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

Develop

Script

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

Environment variables

  • STATA_PATH**: Stata executable path

  • STATA_WORKSPACE**: Stata working directory

License

MIT License.

---.

**Created by the Sociology of Science Research Team โค๏ธ ** **

Congratulations on your Stata MCP server installation! ๐ŸŽ‰ .

Restart the Claude desktop and try it out.

Available Tools

7 tools
browse_do_filesA

์ง€์ •๋œ ๋””๋ ‰ํ† ๋ฆฌ์˜ do ํŒŒ์ผ ๋ชฉ๋ก ์กฐํšŒ

Inputs: directory.

edit_do_fileC

do ํŒŒ์ผ์˜ ํŠน์ • ๋ถ€๋ถ„ ํŽธ์ง‘

Inputs: params (required), file_path (required), operation (required).

generate_do_templateB

LLM์„ ํ™œ์šฉํ•œ do ํŒŒ์ผ ํ…œํ”Œ๋ฆฟ ์ƒ์„ฑ

Inputs: description (required), output_path (required).

read_do_fileC

๋กœ์ปฌ ์ปดํ“จํ„ฐ์˜ do ํŒŒ์ผ ์ฝ๊ธฐ

Inputs: file_path (required).

run_do_fileC

Stata์—์„œ do ํŒŒ์ผ ์‹คํ–‰

Inputs: file_path (required).

run_do_selected_linesB

do ํŒŒ์ผ์˜ ์„ ํƒ๋œ ๋ผ์ธ๋“ค๋งŒ ์‹คํ–‰

Inputs: end_line (required), file_path (required), start_line (required).

write_do_fileC

do ํŒŒ์ผ ์ƒ์„ฑ ๋˜๋Š” ๋ฎ์–ด์“ฐ๊ธฐ

Inputs: content (required), file_path (required), create_backup.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelogโ€ฆ

    TDQS

    A3.5/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool targets a distinct aspect of do file management: browsing directories, reading, writing, editing, generating templates, and running files or selected lines. There is minimal overlap between tools, and their purposes are clear from names and descriptions.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (e.g., browse_do_files, run_do_file, generate_do_template). Naming conventions are uniform and predictable across the entire set.

    Tool Count5/5

    With 7 tools, the server is well-scoped for its purpose of managing and executing Stata do files. Each tool covers a necessary function without redundancy or bloat.

    Completeness5/5

    The tool surface covers the full lifecycle of do file work: discover, view, create, edit, template, and run (both full and partial). There are no obvious gaps that would prevent an agent from completing typical Stata workflows.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      A cross-platform desktop MCP server that allows Codex and other MCP clients to execute tasks via the Claude Agent SDK, providing tools for code generation, file editing, and task management with session continuation.
      14
      MIT