<h1 align="center"> <img src="src/img/logo_with_name.jpg" alt="logo" width="300"/> </h1>

Let LLM help you achieve your regression analysis with Stata.

Currently supports macOS only (as of 20250402)

Good News! Windows will be supported at the end of April 2025.

---

💡 Quick Start

For more detailed usage information, visit the Usage guide.

Prerequisites

• uv - Package installer and virtual environment manager
• Claude, Cline, ChatWise, or other LLM service
• Stata License
• Your API-KEY from LLM

Installation

# Clone the repository
git clone https://github.com/sepinetam/stata-mcp.git
cd stata-mcp

# Copy example config
cp example.config.py config.py

# Using uv (recommended)
uv run stata_mcp.py 17 se  # Test run with Stata 17 SE

# Alternative setup with pip
# python3.11 -m venv .venv
# source .venv/bin/activate
# pip install -r requirements.txt

Note: Windows support is not currently available. If you have a Stata license for Windows and would like to contribute, please submit a PR.

🔧 MCP Server Configuration

Claude

{
  "stata-mcp": {
    "command":"uv",
    "args":[
      "--directory",
      "/Users/yourname/path/to/repo/",
      "run",
      "stata_mcp.py",
      "17",
      "se"
    ]
  }
}

ChatWise

Open ChatWise app and navigate to the tools tab (subscription required):

type: stdio
ID: stata-mcp
command: uv --directory /Users/yourname/path/to/repo/ run stata_mcp.py 17 se

Cline

{
  "mcpServers": {
    "stata-mcp": {
      "command":"uv",
      "args":[
        "--directory",
        "/Users/yourname/path/to/repo/",
        "run",
        "stata_mcp.py",
        "17",
        "se"
      ]
    }
  }
}

📝 Documentation

For more detailed usage information, visit the Usage guide.

💡 Questions

• Cherry Studio 32000 wrong

🚀 Roadmap

• [x] macOS support
• [ ] Windows support
• [ ] Additional LLM integrations
• [ ] Performance optimizations

⚠️ Disclaimer

This project is for research purposes only. I am not responsible for any damage caused by this project. Please ensure you have proper licensing to use Stata.

For more information, refer to the Statement.

🐛 Report Issues

If you encounter any bugs or have feature requests, please open an issue.

📄 License

MIT License

📚 Citation

If you use Stata-MCP in your research, please cite this repository using one of the following formats:

BibTeX

@software{sepinetam2025stata,
  author = {Song Tan},
  title = {Stata-MCP: Let LLM help you achieve your regression analysis with Stata},
  year = {2025},
  url = {https://github.com/sepinetam/stata-mcp},
  version = {1.0.3}
}

APA

Song Tan. (2025). Stata-MCP: Let LLM help you achieve your regression analysis with Stata (Version 1.0.3) [Computer software]. https://github.com/sepinetam/stata-mcp

Chicago

Song Tan. 2025. "Stata-MCP: Let LLM help you achieve your regression analysis with Stata." Version 1.0.3. https://github.com/sepinetam/stata-mcp.

📬 Contact

Email: sepinetam@gmail.com

Or contribute directly by submitting a Pull Request! We welcome contributions of all kinds, from bug fixes to new features.

✨ Star History