Stata MCP Server

Расширение 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