Skip to content

Commit 029d97a

Browse files
SepineTamSepineTam
committed
Merge branch 'refs/heads/master' into release/1.6.x/webui
# Conflicts: # README.md # source/docs/README/cn/README.md # source/docs/README/fr/README.md # source/docs/README/sp/README.md
2 parents 8e015ac + 83946e3 commit 029d97a

File tree

5 files changed

+60
-39
lines changed

5 files changed

+60
-39
lines changed

‎README.md‎

Lines changed: 8 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -15,17 +15,18 @@
1515
[![PyPI version](https://img.shields.io/pypi/v/stata-mcp.svg)](https://pypi.org/project/stata-mcp/)
1616
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
1717
[![Issue](https://img.shields.io/badge/Issue-report-green.svg)](https://github.com/sepinetam/stata-mcp/issues/new)
18-
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/SepineTam/Stata-MCP)
18+
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/SepineTam/stata-mcp)
1919

2020
---
2121

2222
> Looking for other Stata integrations or others?
2323
>
2424
> - A VScode or Cursor integrated [here](https://github.com/hanlulong/stata-mcp). Confused it? 💡 [Difference](source/docs/Difference.md)
25-
> - Jupyter Lab Usage (Important: Stata 17+) [here](https://github.com/hanlulong/stata-mcp/blob/main/docs/jupyter-stata.md)
25+
> - Jupyter Lab Usage (Important: Stata 17+) [here](https://github.com/sepinetam/Jupyter-Stata)
2626
> - [NBER-MCP](https://github.com/sepinetam/NBER-MCP) 🔧 under construction
2727
> - [AER-MCP](https://github.com/sepinetam/AER-MCP)
2828
> - [Econometrics-Agent](https://github.com/FromCSUZhou/Econometrics-Agent)
29+
> - [TexIV](https://github.com/sepinetam/TexIV)
2930
3031
## 💡 Quick Start
3132
> Standard config requires: please make sure the stata is installed at the default path, and the stata cli (for macOS and Linux) exists.
@@ -44,9 +45,7 @@ The standard config json as follows, you can DIY your config via add envs.
4445
}
4546
```
4647

47-
For more detailed usage information, visit the [Usage guide](source/docs/Usages/Usage.md).
48-
49-
Configuration values are stored in `~/.stata-mcp/config.toml`. See the [Configuration guide](source/docs/Usages/Configuration.md) for details.
48+
For more detailed usage information, visit the [Usage guide](source/docs/Usages/Usage.md).
5049

5150
And some advanced usage, visit the [Advanced guide](source/docs/Usages/Advanced.md)
5251

@@ -61,7 +60,6 @@ For the new version, you don't need to install the `stata-mcp` package again, yo
6160
```bash
6261
uvx stata-mcp --usable
6362
uvx stata-mcp --version
64-
uvx stata-mcp --webui
6563
```
6664

6765
If you want to use it locally, you can install it via pip or download the source code.
@@ -82,12 +80,11 @@ Then you can find the compiled `stata-mcp` binary in the `dist` directory. You c
8280

8381
For example:
8482
```bash
85-
uvx /path/to/your/whl/stata_mcp-1.6.0-py3-non-any.whl # here is the wheel file name, you can change it to your version
83+
uvx /path/to/your/whl/stata_mcp-1.5.3-py3-non-any.whl # here is the wheel file name, you can change it to your version
8684
```
8785

8886
## 📝 Documentation
8987
- For more detailed usage information, visit the [Usage guide](source/docs/Usages/Usage.md).
90-
- See how to edit the config file in the [Configuration guide](source/docs/Usages/Configuration.md).
9188
- Advanced Usage, visit the [Advanced](source/docs/Usages/Advanced.md)
9289
- Some questions, visit the [Questions](source/docs/Usages/Questions.md)
9390
- Difference with [Stata-MCP@hanlulong](https://github.com/hanlulong/stata-mcp), visit the [Difference](source/docs/Difference.md)
@@ -125,18 +122,18 @@ If you use Stata-MCP in your research, please cite this repository using one of
125122
title = {Stata-MCP: Let LLM help you achieve your regression analysis with Stata},
126123
year = {2025},
127124
url = {https://github.com/sepinetam/stata-mcp},
128-
version = {1.6.0}
125+
version = {1.5.3}
129126
}
130127
```
131128

132129
### APA
133130
```
134-
Song Tan. (2025). Stata-MCP: Let LLM help you achieve your regression analysis with Stata (Version 1.6.0) [Computer software]. https://github.com/sepinetam/stata-mcp
131+
Song Tan. (2025). Stata-MCP: Let LLM help you achieve your regression analysis with Stata (Version 1.5.3) [Computer software]. https://github.com/sepinetam/stata-mcp
135132
```
136133

137134
### Chicago
138135
```
139-
Song Tan. 2025. "Stata-MCP: Let LLM help you achieve your regression analysis with Stata." Version 1.6.0. https://github.com/sepinetam/stata-mcp.
136+
Song Tan. 2025. "Stata-MCP: Let LLM help you achieve your regression analysis with Stata." Version 1.5.3. https://github.com/sepinetam/stata-mcp.
140137
```
141138

142139
## 📬 Contact

‎source/docs/ProblemCatalog.md‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
# Problem Catalog
2+
- [🇨🇳 中文](#已知问题)
3+
- [🇬🇧 English](#known-problems)
4+
5+
---
6+
7+
# 已知问题
8+
针对该项目，目前已发现以下问题，欢迎通过 issue 或 PR 进行补充：
9+
10+
## 懒惰
11+
在缺乏合适提示词的情况下（即便偶尔给出较好的提示词也会如此），模型在使用 Stata-MCP 时常表现出“懒惰”行为：
12+
- 执行任务时不主动读取 log 文件；
13+
- 集成读取 log 的操作后，只编写 do-file 而不执行；
14+
- 即使流程全部整合，仍可能只返回文本代码而不真正生成 do-file。
15+
16+
## 蝴蝶效应
17+
在执行 do-file 时若出现小错误，模型往往难以自行解决，从而不断尝试（通常是错误方法），形成死循环。这通常源于其对 Stata 语法的不熟悉。
18+
19+
---
20+
21+
# Known Problems
22+
The following issues have been observed in this project. Feel free to open an issue or submit a PR if you discover more.
23+
24+
## Laziness
25+
Without well-crafted prompts (and sometimes even with them), the model tends to act lazily when using Stata-MCP:
26+
- It skips reading log files during execution;
27+
- After log reading is added to the do-file, it may only write the do-file without running it;
28+
- Even when all steps are combined, the model might output the code as plain text instead of actually writing a do-file.
29+
30+
## Butterfly Effect
31+
When a minor error occurs while running a do-file, the model often fails to resolve it and keeps trying incorrect fixes, leading to an infinite loop. This behavior usually stems from limited familiarity with Stata syntax.

‎source/docs/README/cn/README.md‎

Lines changed: 7 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -15,17 +15,18 @@
1515
[![PyPI version](https://img.shields.io/pypi/v/stata-mcp.svg)](https://pypi.org/project/stata-mcp/)
1616
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](../../../../LICENSE)
1717
[![Issue](https://img.shields.io/badge/Issue-report-green.svg)](https://github.com/sepinetam/stata-mcp/issues/new)
18-
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/SepineTam/Stata-MCP)
18+
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/SepineTam/stata-mcp)
1919

2020
---
2121

2222
> 正在寻找其他 Stata 集成？
2323
>
2424
> - VScode 或 Cursor 集成 [此处](https://github.com/hanlulong/stata-mcp)。搞不清楚？️💡 [区别](../../Difference.md)
25-
> - Jupyter Lab 使用方法（重要提示：Stata 17+）[此处](https://github.com/hanlulong/stata-mcp/blob/main/docs/jupyter-stata.md)
25+
> - Jupyter Lab 使用方法（重要提示：Stata 17+）[此处](https://github.com/sepinetam/Jupyter-Stata)
2626
> - [NBER-MCP](https://github.com/sepinetam/NBER-MCP) 🔧 建造之下
2727
> - [AER-MCP](https://github.com/sepinetam/AER-MCP)
2828
> - [Econometrics-Agent](https://github.com/FromCSUZhou/Econometrics-Agent)
29+
> - [TexIV](https://github.com/sepinetam/TexIV)
2930
3031

3132
## 💡 快速开始
@@ -47,8 +48,6 @@
4748

4849
有关更详细的使用信息，请访问[使用指南](../../Usages/Usage.md)。
4950

50-
配置文件位于 `~/.stata-mcp/config.toml`，详见[配置指南](../../Usages/Configuration.md)。
51-
5251
一些高级的功能，访问[高级指南](../../Usages/Advanced.md)
5352

5453
### 前提条件
@@ -62,7 +61,6 @@
6261
```bash
6362
uvx stata-mcp --usable
6463
uvx stata-mcp --version
65-
uvx stata-mcp --webui
6664
```
6765

6866
如果您希望在本地使用，也可以通过 pip 安装或下载源代码并编译。
@@ -83,12 +81,11 @@ uv build
8381

8482
例如：
8583
```bash
86-
uvx /path/to/your/whl/stata_mcp-1.6.0-py3-non-any.whl # 这里的文件名可根据版本修改
84+
uvx /path/to/your/whl/stata_mcp-1.5.3-py3-non-any.whl # 这里的文件名可根据版本修改
8785
```
8886

8987
## 📝 文档
9088
- 有关更详细的使用信息，请访问[使用指南](../../Usages/Usage.md)。
91-
- 了解如何编辑配置文件，请阅读[配置指南](../../Usages/Configuration.md)。
9289
- 高级用法，请访问[高级指南](../../Usages/Advanced.md)
9390
- 一些问题，请访问[问题](../../Usages/Questions.md)
9491
- 与[Stata-MCP@hanlulong](https://github.com/hanlulong/stata-mcp)的区别，请访问[区别](../../Difference.md)
@@ -126,18 +123,18 @@ uvx /path/to/your/whl/stata_mcp-1.6.0-py3-non-any.whl # 这里的文件名可
126123
title = {Stata-MCP: Let LLM help you achieve your regression analysis with Stata},
127124
year = {2025},
128125
url = {https://github.com/sepinetam/stata-mcp},
129-
version = {1.6.0}
126+
version = {1.5.3}
130127
}
131128
```
132129

133130
### APA
134131
```
135-
Song Tan. (2025). Stata-MCP: Let LLM help you achieve your regression analysis with Stata (Version 1.6.0) [Computer software]. https://github.com/sepinetam/stata-mcp
132+
Song Tan. (2025). Stata-MCP: Let LLM help you achieve your regression analysis with Stata (Version 1.5.3) [Computer software]. https://github.com/sepinetam/stata-mcp
136133
```
137134

138135
### Chicago
139136
```
140-
Song Tan. 2025. "Stata-MCP: Let LLM help you achieve your regression analysis with Stata." Version 1.6.0. https://github.com/sepinetam/stata-mcp.
137+
Song Tan. 2025. "Stata-MCP: Let LLM help you achieve your regression analysis with Stata." Version 1.5.3. https://github.com/sepinetam/stata-mcp.
141138
```
142139

143140
## 📬 联系方式

‎source/docs/README/fr/README.md‎

Lines changed: 7 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -15,17 +15,18 @@
1515
[![PyPI version](https://img.shields.io/pypi/v/stata-mcp.svg)](https://pypi.org/project/stata-mcp/)
1616
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](../../../../LICENSE)
1717
[![Issue](https://img.shields.io/badge/Issue-report-green.svg)](https://github.com/sepinetam/stata-mcp/issues/new)
18-
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/SepineTam/Stata-MCP)
18+
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/SepineTam/stata-mcp)
1919

2020
---
2121

2222
> Vous cherchez d'autres intégrations Stata?
2323
>
2424
> - Une intégration VScode ou Cursor [ici](https://github.com/hanlulong/stata-mcp). Vous êtes perdu? 💡 [Différence](../../Difference.md)
25-
> - Utilisation de Jupyter Lab (Important: Stata 17+) [ici](https://github.com/hanlulong/stata-mcp/blob/main/docs/jupyter-stata.md)
25+
> - Utilisation de Jupyter Lab (Important: Stata 17+) [ici](https://github.com/sepinetam/Jupyter-Stata)
2626
> - [NBER-MCP](https://github.com/sepinetam/NBER-MCP) 🔧 en cours de construction
2727
> - [AER-MCP](https://github.com/sepinetam/AER-MCP)
2828
> - [Econometrics-Agent](https://github.com/FromCSUZhou/Econometrics-Agent)
29+
> - [TexIV](https://github.com/sepinetam/TexIV)
2930
3031
## 💡 Démarrage Rapide
3132
> La configuration standard nécessite que Stata soit installé sur le chemin par défaut et que l'interface en ligne de commande de Stata (pour macOS et Linux) soit disponible.
@@ -45,7 +46,6 @@ Le fichier json de configuration standard est le suivant, vous pouvez personnali
4546
```
4647

4748
Pour des informations d'utilisation plus détaillées, consultez le [guide d'utilisation](../../Usages/Usage.md).
48-
Les valeurs de configuration sont stockées dans `~/.stata-mcp/config.toml`. Consultez le [guide de configuration](../../Usages/Configuration.md) pour plus de détails.
4949

5050
Et pour une utilisation avancée, visitez le [Guide avancé](../../Usages/Advanced.md)
5151

@@ -60,7 +60,6 @@ Pour la nouvelle version, il n'est plus nécessaire d'installer le paquet `stata
6060
```bash
6161
uvx stata-mcp --usable
6262
uvx stata-mcp --version
63-
uvx stata-mcp --webui
6463
```
6564

6665
Si vous souhaitez l'utiliser localement, vous pouvez l'installer via pip ou télécharger le code source puis le compiler.
@@ -81,12 +80,11 @@ Vous trouverez ensuite le binaire `stata-mcp` compilé dans le répertoire `dist
8180

8281
Par exemple:
8382
```bash
84-
uvx /path/to/your/whl/stata_mcp-1.6.0-py3-non-any.whl # modifiez le nom du fichier selon votre version
83+
uvx /path/to/your/whl/stata_mcp-1.5.3-py3-non-any.whl # modifiez le nom du fichier selon votre version
8584
```
8685

8786
## 📝 Documentation
8887
- Pour des informations d'utilisation plus détaillées, consultez le [guide d'utilisation](../../Usages/Usage.md).
89-
- Consultez le [guide de configuration](../../Usages/Configuration.md) pour modifier le fichier de configuration.
9088
- Utilisation avancée, visitez le [Guide avancé](../../Usages/Advanced.md)
9189
- Quelques questions, visitez les [Questions](../../Usages/Questions.md)
9290
- Différence avec [Stata-MCP@hanlulong](https://github.com/hanlulong/stata-mcp), visitez la [Différence](../../Difference.md)
@@ -124,18 +122,18 @@ Si vous utilisez Stata-MCP dans vos recherches, veuillez citer ce référentiel
124122
title = {Stata-MCP: Let LLM help you achieve your regression analysis with Stata},
125123
year = {2025},
126124
url = {https://github.com/sepinetam/stata-mcp},
127-
version = {1.6.0}
125+
version = {1.5.3}
128126
}
129127
```
130128

131129
### APA
132130
```
133-
Song Tan. (2025). Stata-MCP: Let LLM help you achieve your regression analysis with Stata (Version 1.6.0) [Computer software]. https://github.com/sepinetam/stata-mcp
131+
Song Tan. (2025). Stata-MCP: Let LLM help you achieve your regression analysis with Stata (Version 1.5.3) [Computer software]. https://github.com/sepinetam/stata-mcp
134132
```
135133

136134
### Chicago
137135
```
138-
Song Tan. 2025. "Stata-MCP: Let LLM help you achieve your regression analysis with Stata." Version 1.6.0. https://github.com/sepinetam/stata-mcp.
136+
Song Tan. 2025. "Stata-MCP: Let LLM help you achieve your regression analysis with Stata." Version 1.5.3. https://github.com/sepinetam/stata-mcp.
139137
```
140138

141139
## 📬 Contact

‎source/docs/README/sp/README.md‎

Lines changed: 7 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -15,17 +15,18 @@
1515
[![PyPI version](https://img.shields.io/pypi/v/stata-mcp.svg)](https://pypi.org/project/stata-mcp/)
1616
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](../../../../LICENSE)
1717
[![Issue](https://img.shields.io/badge/Issue-report-green.svg)](https://github.com/sepinetam/stata-mcp/issues/new)
18-
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/SepineTam/Stata-MCP)
18+
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/SepineTam/stata-mcp)
1919

2020
---
2121

2222
> ¿Buscando otras integraciones de Stata u otras opciones?
2323
>
2424
> - Una integración para VScode o Cursor [aquí](https://github.com/hanlulong/stata-mcp). ¿Confundido? 💡 [Diferencias](../../Difference.md)
25-
> - Uso en Jupyter Lab (Importante: Stata 17+) [aquí](https://github.com/hanlulong/stata-mcp/blob/main/docs/jupyter-stata.md)
25+
> - Uso en Jupyter Lab (Importante: Stata 17+) [aquí](https://github.com/sepinetam/Jupyter-Stata)
2626
> - [NBER-MCP](https://github.com/sepinetam/NBER-MCP) 🔧 en construcción
2727
> - [AER-MCP](https://github.com/sepinetam/AER-MCP)
2828
> - [Econometrics-Agent](https://github.com/FromCSUZhou/Econometrics-Agent)
29+
> - [TexIV](https://github.com/sepinetam/TexIV)
2930
3031
## 💡 Inicio Rápido
3132
> La configuración estándar requiere que Stata esté instalado en la ruta predeterminada y que exista la interfaz de línea de comandos de Stata (para macOS y Linux).
@@ -45,7 +46,6 @@ El archivo json de configuración estándar es el siguiente; puedes personalizar
4546
```
4647

4748
Para información más detallada sobre el uso, visita la [guía de Uso](../../Usages/Usage.md).
48-
Los valores de configuración se almacenan en `~/.stata-mcp/config.toml`. Consulta la [guía de Configuración](../../Usages/Configuration.md) para más detalles.
4949

5050
Y para un uso más avanzado, visita la [Guía avanzada](../../Usages/Advanced.md)
5151

@@ -60,7 +60,6 @@ Para la nueva versión, no necesitas instalar el paquete `stata-mcp` de nuevo; s
6060
```bash
6161
uvx stata-mcp --usable
6262
uvx stata-mcp --version
63-
uvx stata-mcp --webui
6463
```
6564

6665
Si deseas usarlo de forma local, puedes instalarlo mediante pip o descargar el código fuente y compilarlo.
@@ -81,12 +80,11 @@ A continuación, encontrarás el binario `stata-mcp` compilado en el directorio
8180

8281
Por ejemplo:
8382
```bash
84-
uvx /path/to/your/whl/stata_mcp-1.6.0-py3-non-any.whl # cambia el nombre del archivo según tu versión
83+
uvx /path/to/your/whl/stata_mcp-1.5.3-py3-non-any.whl # cambia el nombre del archivo según tu versión
8584
```
8685

8786
## 📝 Documentación
8887
- Para información más detallada sobre el uso, visita la [guía de Uso](../../Usages/Usage.md).
89-
- Consulta la [guía de Configuración](../../Usages/Configuration.md) para editar el archivo de configuración.
9088
- Uso avanzado, visita la [Guía avanzada](../../Usages/Advanced.md)
9189
- Algunas preguntas, visita las [Preguntas](../../Usages/Questions.md)
9290
- Diferencia con [Stata-MCP@hanlulong](https://github.com/hanlulong/stata-mcp), visita las [Diferencias](../../Difference.md)
@@ -124,18 +122,18 @@ Si utilizas Stata-MCP en tu investigación, por favor cita este repositorio util
124122
title = {Stata-MCP: Let LLM help you achieve your regression analysis with Stata},
125123
year = {2025},
126124
url = {https://github.com/sepinetam/stata-mcp},
127-
version = {1.6.0}
125+
version = {1.5.3}
128126
}
129127
```
130128

131129
### APA
132130
```
133-
Song Tan. (2025). Stata-MCP: Let LLM help you achieve your regression analysis with Stata (Version 1.6.0) [Computer software]. https://github.com/sepinetam/stata-mcp
131+
Song Tan. (2025). Stata-MCP: Let LLM help you achieve your regression analysis with Stata (Version 1.5.3) [Computer software]. https://github.com/sepinetam/stata-mcp
134132
```
135133

136134
### Chicago
137135
```
138-
Song Tan. 2025. "Stata-MCP: Let LLM help you achieve your regression analysis with Stata." Version 1.6.0. https://github.com/sepinetam/stata-mcp.
136+
Song Tan. 2025. "Stata-MCP: Let LLM help you achieve your regression analysis with Stata." Version 1.5.3. https://github.com/sepinetam/stata-mcp.
139137
```
140138

141139
## 📬 Contacto

0 commit comments

Comments
 (0)