Расширение Stata MCP для VS Code и Cursor

Это расширение обеспечивает интеграцию Stata для Visual Studio Code и Cursor IDE с использованием Model Context Protocol (MCP). Расширение позволяет:

• Запускайте команды Stata напрямую из VS Code или Курсора

• Выполнение выделенных фрагментов или целых файлов .do

• Просмотр вывода Stata в редакторе в режиме реального времени

• Интеграция помощника на базе искусственного интеллекта через протокол MCP

• Испытайте улучшенное кодирование ИИ с помощью Cursor или Cline

• Выберите версию Stata (MP, SE или IC)

Функции

• Выполнение команд Stata : выполнение выделенных фрагментов или целых файлов .do непосредственно из редактора.

• Подсветка синтаксиса : полная поддержка синтаксиса для файлов Stata .do, .ado, .mata и .doh

• Интеграция помощника ИИ : контекстная помощь и предложения кода через MCP

• Кроссплатформенность : работает на Windows, macOS и Linux.

• Автоматическое обнаружение Stata : автоматически находит вашу установку Stata

• Вывод в реальном времени : мгновенно просматривайте результаты Stata в своем редакторе

Демо

Посмотрите, как это расширение улучшает ваш рабочий процесс Stata с помощью курсора (или VS Code) и ИИ:

🎬 Полная видеоверсия | 📄 Просмотреть сгенерированный отчет в формате PDF

Подсказка демонстрации: «Создайте и выполните do-файлы Stata, убедившись, что во всех случаях используются полные абсолютные пути к файлам. Загрузите набор данных auto (webuse auto) и сгенерируйте сводную статистику для каждой переменной. Определите и извлеките ключевые характеристики из набора данных, создайте соответствующие графики и сохраните их в папке с именем plots. Проведите регрессионный анализ для изучения основных факторов, определяющих цены на автомобили. Экспортируйте все выходные данные в файл LaTeX и скомпилируйте его. Автоматически устраняйте любые ошибки компиляции и убедитесь, что компиляция LaTeX не превышает 10 секунд. Все ошибки кода должны быть выявлены и устранены в рамках рабочего процесса».

Ищете другие интеграции Stata?

• Используете Stata с Notepad++ и Sublime Text 3? Смотрите здесь

• Использовать Stata MCP в Claude Desktop без установки этого расширения? Смотрите здесь

• Использовать Stata через Jupyter? Смотрите здесь

Требования

• На вашем компьютере установлена Stata 17 или выше

• Менеджер пакетов UV (устанавливается автоматически или может быть установлен вручную при необходимости)

Установка

Примечание: Первоначальная установка требует настройки зависимостей, что может занять до 2 минут. Пожалуйста, будьте терпеливы во время этого одноразового процесса настройки. Все последующие запуски будут запускаться мгновенно.

Установка VS-кода

Вариант 1: Из VS Code Marketplace

Установите это расширение прямо из VS Code Marketplace .

Или:

1. Открыть VS Код

2. Перейти к просмотру расширений (Ctrl+Shift+X)

3. Поиск по запросу "Stata MCP"

4. Нажмите «Установить».

Вариант 2: Из файла .vsix

1. Загрузите пакет расширения stata-mcp-0.2.3.vsix со страницы релизов .

2. Установите одним из следующих способов:

Или:

1. Открыть VS Код

2. Перейти к просмотру расширений (Ctrl+Shift+X)

3. Нажмите на меню «...» в правом верхнем углу.

4. Выберите «Установить из VSIX...»

5. Перейдите и выберите загруженный файл .vsix.

Установка курсора

1. Загрузите пакет расширения stata-mcp-0.2.3.vsix со страницы релизов .

2. Установите одним из следующих способов:

Или:

1. Открытый курсор

2. Перейти к просмотру расширений

3. Нажмите на меню «...»

4. Выберите «Установить из VSIX»

5. Перейдите и выберите загруженный файл .vsix.

Начиная с версии 0.1.8, расширение интегрирует быстрый установщик пакетов Python, называемый uv , для настройки среды. Если uv не найден в вашей системе, расширение попытается установить его автоматически.

Настройки расширения

Вы можете настроить поведение расширения через настройки VS Code:

• stata-vscode.stataPath : Путь к установочному каталогу Stata

• stata-vscode.mcpServerHost : Хост для сервера MCP (по умолчанию: localhost)

• stata-vscode.mcpServerPort : Порт для сервера MCP (по умолчанию: 4000)

• stata-vscode.autoStartServer : автоматически запускать сервер MCP при активации расширения (по умолчанию: true)

• stata-vscode.debugMode : Показывать подробную отладочную информацию на панели вывода (по умолчанию: false)

• stata-vscode.forcePort : принудительно заставить сервер MCP использовать указанный порт, даже если он уже используется (по умолчанию: false)

• stata-vscode.clineConfigPath : Пользовательский путь к файлу конфигурации Cline (необязательно, по умолчанию используются стандартные расположения)

• stata-vscode.runFileTimeout : Время ожидания в секундах для операций «Запустить файл» (по умолчанию: 600 секунд / 10 минут)

• stata-vscode.stataEdition : используемая редакция Stata (MP, SE, IC) — по умолчанию: MP

Использование

1. Откройте файл Stata .do

2. Запускайте команды, используя:

   • Выполнить выделение : выберите код Stata и нажмите Ctrl+Shift+Enter (или Cmd+Shift+Enter на Mac)

   • Запустить файл : нажмите Ctrl+Shift+D (или Cmd+Shift+D на Mac), чтобы запустить весь файл .do.

3. Просмотр вывода на панели редактора

4. Выберите версию Stata : выберите предпочтительную версию Stata (MP, SE или IC) в настройках расширения.

Как это работает

Расширение создает локальный сервер MCP, который подключает ваш редактор к Stata, обеспечивая:

1. Выполнение команд : запускайте команды Stata и мгновенно смотрите результаты.

2. Контекстная осведомленность : помощники ИИ понимают ваши данные и команды Stata

3. Повышение производительности : получайте разумные предложения по коду и документацию

Конфигурация курсора MCP

Расширение автоматически настраивает интеграцию Cursor MCP. Чтобы проверить, работает ли оно:

1. Открытый курсор

2. Нажмите Ctrl+Shift+P (или Cmd+Shift+P на Mac), чтобы открыть палитру команд.

3. Введите «Stata: Тест соединения с сервером MCP» и нажмите Enter.

4. Если сервер подключен правильно, вы должны увидеть сообщение об успешном завершении.

Пути к файлам конфигурации курсора

Расположение файлов конфигурации Cursor MCP зависит от операционной системы:

• macOS :

  • Основное расположение: ~/.cursor/mcp.json

  • Альтернативное расположение: ~/Library/Application Support/Cursor/User/mcp.json

• Окна :

  • Основное расположение: %USERPROFILE%\.cursor\mcp.json

  • Альтернативное расположение: %APPDATA%\Cursor\User\mcp.json

• Линукс :

  • Основное расположение: ~/.cursor/mcp.json

  • Альтернативное расположение: ~/.config/Cursor/User/mcp.json

Ручная настройка курсора

Если вам необходимо вручную настроить Cursor MCP:

1. Создайте или отредактируйте файл конфигурации MCP:

   • macOS/Linux : ~/.cursor/mcp.json

   • Windows : %USERPROFILE%\.cursor\mcp.json

2. Добавьте конфигурацию сервера Stata MCP:

   { "mcpServers": { "stata-mcp": { "url": "http://localhost:4000/mcp", "transport": "sse" } } }

3. Если файл уже содержит другие серверы MCP, просто добавьте запись "stata-mcp" к существующему объекту "mcpServers" .

4. Сохраните файл и перезапустите Cursor.

Устранение неполадок конфигурации курсора

Если Cursor не распознает сервер Stata MCP:

1. Убедитесь, что сервер MCP работает

2. Проверьте, что файл конфигурации существует и имеет правильное содержимое.

3. Попробуйте перезапустить курсор

4. Убедитесь, что нет конфликтов портов с другими запущенными приложениями.

Конфигурация Клайн MCP

1. Откройте файл настроек Cline MCP:

   • macOS : ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

   • Windows : %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

   • Linux : ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

2. Добавьте конфигурацию сервера Stata MCP:

   { "mcpServers": { "stata-mcp": { "url": "http://localhost:4000/mcp", "transport": "sse" } } }

3. Если файл уже содержит другие серверы MCP, просто добавьте запись "stata-mcp" к существующему объекту "mcpServers" .

4. Сохраните файл и перезапустите VS Code.

Вы также можете настроить Cline через настройки VS Code:

Устранение неполадок конфигурации Cline

Если Cline не распознает сервер Stata MCP:

1. Убедитесь, что сервер MCP запущен (в строке состояния должно отображаться «Stata»).

2. Проверьте, что файл конфигурации существует и имеет правильное содержимое.

3. Попробуйте перезапустить VS Code.

4. Проверьте панель вывода расширения (Вид > Вывод > Stata MCP) на наличие ошибок.

Конфигурация MCP рабочего стола Клода

Вы можете использовать это расширение с Claude Desktop через mcp-proxy:

1. Перед попыткой настройки Claude Desktop убедитесь, что расширение Stata MCP установлено в VS Code или Cursor и в настоящее время запущено.

2. Установите mcp-proxy:

   # Using pip pip install mcp-proxy # Or using uv (faster) uv install mcp-proxy

3. Найдите путь к mcp-proxy:

   # On Mac/Linux which mcp-proxy # On Windows (PowerShell) (Get-Command mcp-proxy).Path

4. Настройте Claude Desktop, отредактировав файл конфигурации MCP:

   В Windows (обычно в %APPDATA%\Claude Desktop\claude_desktop_config.json ):

   { "mcpServers": { "stata-mcp": { "command": "mcp-proxy", "args": ["http://127.0.0.1:4000/mcp"] } } }

   В macOS (обычно в ~/Library/Application Support/Claude Desktop/claude_desktop_config.json ):

   { "mcpServers": { "stata-mcp": { "command": "/path/to/mcp-proxy", "args": ["http://127.0.0.1:4000/mcp"] } } }

   Замените /path/to/mcp-proxy фактическим путем, который вы нашли на шаге 3.

5. Перезагрузить рабочий стол Клода

6. Claude Desktop автоматически обнаружит доступные инструменты Stata, что позволит вам запускать команды Stata и анализировать данные непосредственно из ваших разговоров.

Примечание: Существует альтернативный способ использования Stata MCP в Claude Desktop без установки этого расширения. Смотрите здесь .

Управление средой Python

Это расширение использует uv , быстрый установщик пакетов Python, встроенный в Rust, для управления зависимостями Python. Основные функции:

• Автоматическая настройка Python и управление зависимостями

• Создает изолированные среды, которые не будут конфликтовать с вашей системой

• Работает в Windows, macOS и Linux

• В 10–100 раз быстрее, чем традиционная установка труб

Если во время установки у вас возникли какие-либо ошибки, связанные с УФ-излучением:

1. Установите УФ вручную:

   # Windows (PowerShell as Administrator) powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" # macOS/Linux curl -LsSf https://astral.sh/uv/install.sh | sh

2. Чтобы переустановить расширение, следуйте инструкциям по устранению неполадок.

Начиная с версии 0.1.8, это расширение интегрирует быстрый установщик пакетов Python uv для настройки среды. Если uv не найден в вашей системе, расширение попытается установить его автоматически.

Поиск неисправностей

Если у вас возникли проблемы с расширением, выполните следующие действия для полной переустановки:

Окна

1. Закрыть все окна VS Code/Cursor

2. Откройте диспетчер задач (Ctrl+Shift+Esc):

   • Перейдите на вкладку «Процессы»

   • Найдите все запущенные процессы Python или uvicorn

   • Выберите каждую из них и нажмите «Завершить задачу».

3. Удалить папку расширения:

   • Нажмите Win+R, введите %USERPROFILE%\.vscode\extensions и нажмите Enter.

   • Удалить папку deepecon.stata-mcp-0.xx (где xx — номер версии)

   • Для курсора: путь %USERPROFILE%\.cursor\extensions

4. Установите УФ вручную (при необходимости):

   # Open PowerShell as Administrator and run: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

5. Перезагрузите компьютер (рекомендуется, но необязательно)

6. Установите последнюю версию расширения из Marketplace

macOS/Linux

1. Закрыть все окна VS Code/Cursor

2. Завершите все запущенные процессы Python:

   # Find Python processes ps aux | grep python # Kill them (replace <PID> with the process numbers you found) kill -9 <PID>

3. Удалить папку расширения:

   # For VS Code: rm -rf ~/.vscode/extensions/deepecon.stata-mcp-0.x.x # For Cursor: rm -rf ~/.cursor/extensions/deepecon.stata-mcp-0.x.x

4. Установите УФ вручную (при необходимости):

   # Using curl: curl -LsSf https://astral.sh/uv/install.sh | sh # Or using wget: wget -qO- https://astral.sh/uv/install.sh | sh

5. Перезагрузите терминал или компьютер (рекомендуется, но необязательно)

6. Установите последнюю версию расширения из Marketplace

Дополнительные советы по устранению неполадок

• Если вы видите ошибки о том, что Python или UV не найдены, убедитесь, что они находятся в системной переменной PATH:

  • Windows: введите «Переменные среды» в меню «Пуск» и добавьте пути установки.

  • macOS/Linux: Добавьте пути к ~/.bashrc , ~/.zshrc или эквиваленту

• Если вы получаете ошибки разрешений:

  • Windows: Запустите VS Code/Cursor от имени администратора.

  • macOS/Linux: проверьте права доступа к папке с помощью ls -la и исправьте с помощью chmod если необходимо

• Если расширение по-прежнему не инициализируется:

  1. Откройте панель «Вывод» (Вид -> Вывод)

  2. Выберите «Stata-MCP» из выпадающего списка.

  3. Проверьте журналы на наличие конкретных сообщений об ошибках.

  4. Если вы видите ошибки, связанные с Python, попробуйте вручную создать виртуальную среду Python 3.11:

     # Windows py -3.11 -m venv .venv # macOS/Linux python3.11 -m venv .venv

• Для постоянных проблем:

  1. Проверьте установку Python в вашей системе: python --version или python3 --version

  2. Проверьте установку UV: uv --version

  3. Убедитесь, что у вас установлен Python 3.11 или более поздней версии.

  4. Проверьте, блокирует ли ваш антивирус исполняемые файлы Python или UV.

• Если у вас возникли проблемы с определенной версией Stata:

  1. Убедитесь, что выбранная версия Stata (MP, SE или IC) соответствует той, что установлена в вашей системе.

  2. Попробуйте изменить настройку stata-vscode.stataEdition в соответствии с установленной версией.

  3. Перезапустите расширение после изменения настроек.

При открытии вопроса на GitHub, пожалуйста, предоставьте:

• Полное сообщение об ошибке из панели вывода (Вид -> Вывод -> Stata-MCP)

• Ваша операционная система и версия

• Версия VS Code/Cursor

• Версия Python ( python --version )

• УФ-версия ( uv --version )

• Действия по воспроизведению проблемы

• Любые соответствующие файлы журналов или снимки экрана

• Содержимое файла конфигурации MCP, если применимо

Эта подробная информация поможет нам быстрее определить и устранить проблему. Вы можете открыть проблемы на: GitHub Issues

Лицензия

Массачусетский технологический институт

Кредиты

Создано Лу Ханом Опубликовано DeepEcon