项目介绍
新闻：
- 在Claude Code中使用Stata-MCP，请参见这里
- 尝试使用代理模式作为工具？现在支持更方便了这里。
- 想要评估您的LLM？请参见这里。
- 更新了
StataFinder，但还不稳定，请配置您的STATA_CLI到环境变量。
寻找其他内容？
- STOP: StataMCP团队开源项目📊，我们已经开源了一个全面的社会科学研究数据集集合，旨在推动未来由AI驱动和数据驱动的研究范式。
- Trace DID: 如果你想获取最新的关于DID（差异法）的信息，请点击这里。现在有一个中文翻译版本由Sepine Tam和StataMCP-Team提供🎉
- Jupyter Lab 使用方法（重要：Stata 17+）这里
- NBER-MCP & AER-MCP 🔧 正在建设中
- Econometrics-Agent
- TexIV: 一个基于机器学习的框架，利用先进的自然语言处理和机器学习技术将文本数据转化为可用于实证研究的变量
- 集成到VScode或Cursor 这里。不清楚吗？💡 差异
💡 快速开始
在Claude Code中使用Stata-MCP
我们可以利用Claude Code中的Stata-MCP代理能力。
在使用之前，请确保已安装Claude Code，如果不知道如何安装，请访问GitHub
您可以在终端中cd到工作目录，并运行：
claude mcp add stata-mcp --env STATA_MCP_CWD=$(pwd) -- uvx stata-mcp
我不确定它是否能在Windows上运行，因为我没有Windows设备来测试它。
然后，您可以在Claude Code中使用Stata-MCP。以下是一些使用场景：
- 论文复制：复现经济学论文中的实证研究
- 快速假设检验：通过回归分析验证经济假设
- Stata学习助手：通过逐步解释学习计量经济学
- 代码组织：审查和优化现有的Stata do文件
- 结果解释：理解复杂的统计输出和回归结果
代理模式
代理模式的详细信息请参见这里。
git clone https://github.com/sepinetam/stata-mcp.git
cd stata-mcp
uv sync
uv pip install -e .
stata-mcp --version # 测试stata-mcp是否成功安装。
stata-mcp --agent # 现在您可以享受stata-mcp代理模式。
或者您可以直接使用uvx：
uvx stata-mcp --version # 测试是否可以在您的计算机上使用。
uvx stata-mcp --agent
您可以在agent_examples/openai/main.py中编辑任务，修改变量model_instructions和task_message，点击我 #L37 和 #L68
代理作为工具
如果您想在另一个代理中使用Stata-Agent，这里是一个简单的示例：
import asyncio
from agents import Agent, Runner
from stata_mcp.agent_as.agent_as_tool import StataAgent
# 初始化stata代理并设置为工具
stata_agent = StataAgent()
sa_tool = stata_agent.as_tool()
# 创建主代理
agent = Agent(
name="助理",
instructions="您是一个乐于助人的助手",
tools=[sa_tool],
)
# 然后像平常一样运行代理。
async def main(task: str, max_turns: int = 30):
result = await Runner.run(agent, input=task, max_turns=max_turns)
return result
if __name__ == "__main__":
econ_task = "使用Stata默认数据找出mpg与价格之间的关系。"
asyncio.run(main(econ_task))
AI聊天机器人客户端模式
标准配置要求：请确保Stata已安装在默认路径下，并且存在Stata CLI（针对macOS和Linux）。
标准配置json如下，您可以DIY您的配置通过添加环境变量。
{
"mcpServers": {
"stata-mcp": {
"command": "uvx",
"args": [
"stata-mcp"
]
}
}
}
更多详细的使用信息，请访问使用指南。
一些高级用法，请访问高级指南
先决条件
- uv - 包装程序安装器和虚拟环境管理器
- Claude、Cline、ChatWise或其他LLM服务
- Stata许可证
- 您从LLM获得的API-KEY
注意事项：
- 如果您在中国，可以在这里找到一份简短的uv使用文档这里。
- 对于Stata-MCP，Claude是最好的选择，对于中文用户，我推荐使用DeepSeek作为您的模型提供商，因为它便宜且强大，在中国供应商中得分最高，如果您对此感兴趣，请访问报告如何使用StataMCP提高您的社会科学研究。
安装
对于新版本，您不需要再次安装stata-mcp包，您可以使用以下命令检查您的计算机是否可以使用stata-mcp。
uvx stata-mcp --usable
uvx stata-mcp --version
如果您想本地使用它，可以通过pip安装或下载源代码。
通过pip下载
pip install stata-mcp
下载源代码并编译
git clone https://github.com/sepinetam/stata-mcp.git
cd stata-mcp
uv build
然后您可以在dist目录中找到编译好的stata-mcp二进制文件。您可以直接使用它或将它添加到PATH中。
例如：
uvx /path/to/your/whl/stata_mcp-1.13.0-py3-non-any.whl # 这里是wheel文件名，您可以更改为您自己的版本
📝 文档
- 更多详细的使用信息，请访问使用指南。
- 高级用法，请访问高级
- 一些问题，请访问问题
- 与Stata-MCP@hanlulong的区别，请访问差异
💡 问题
🚀 路线图
- macOS 支持
- Windows 支持
- 额外的LLM集成（带有新的webUI）
- 性能优化（通过提示和上下文工程）
更多信息，请参考声明。
🐛 报告问题
如果您遇到任何bug或有功能请求，请打开一个issue。
📄 许可证
📚 引用
如果您在研究中使用了Stata-MCP，请使用以下格式之一引用此仓库：
BibTeX
@software{sepinetam2025stata,
author = {宋谭},
title = {Stata-MCP: 让LLM帮助您使用Stata实现回归分析},
year = {2025},
url = {https://github.com/sepinetam/stata-mcp},
version = {1.13.0}
}
APA
宋谭. (2025). Stata-MCP: 让LLM帮助您使用Stata实现回归分析 (版本 1.13.0) [计算机软件]. https://github.com/sepinetam/stata-mcp
芝加哥
宋谭. 2025. "Stata-MCP: 让LLM帮助您使用Stata实现回归分析." 版本 1.13.0. https://github.com/sepinetam/stata-mcp.
📬 联系方式
或者直接通过提交拉取请求! 我们欢迎各种贡献，从修复bug到新增功能。
❤️ 致谢
作者衷心感谢Stata官方团队的支持以及Stata许可证授权的测试开发。
📃 声明
本项目中提到的Stata是指由StataCorp LLC开发的商业软件Stata。本项目未得到StataCorp LLC的认可、赞助或关联。本项目不包含Stata软件或任何安装包；用户必须从StataCorp获取并安装有效的Stata许可证副本。本项目根据Apache-2.0许可。项目维护者不对因使用本项目或与Stata相关的任何行动而引起的任何损失或损害承担责任。
更多信息：请参阅中文版[source/docs/README/cn/README.md]；如有冲突，以中文版为准。