VS Code 및 커서용 Stata MCP 확장

이 확장 기능은 모델 컨텍스트 프로토콜(MCP)을 사용하여 Visual Studio Code 및 커서 IDE에 Stata 통합 기능을 제공합니다. 이 확장 기능을 사용하면 다음 작업을 수행할 수 있습니다.

VS Code 또는 Cursor에서 직접 Stata 명령 실행
선택 항목 또는 전체 .do 파일 실행
편집기에서 Stata 출력을 실시간으로 확인하세요
MCP 프로토콜을 통해 AI 어시스턴트 통합을 얻으세요
Cursor 또는 Cline으로 향상된 AI 코딩을 경험하세요

특징

Stata 명령 실행 : 편집기에서 직접 선택 항목이나 전체 .do 파일을 실행합니다.
구문 강조 : Stata .do, .ado, .mata 및 .doh 파일에 대한 전체 구문 지원
AI Assistant 통합 : MCP를 통한 상황별 도움말 및 코드 제안
크로스 플랫폼 : Windows, macOS 및 Linux에서 작동합니다.
자동 Stata 감지 : Stata 설치를 자동으로 찾습니다.
실시간 출력 : 편집기에서 Stata 결과를 즉시 확인하세요

데모

이 확장 기능이 커서(또는 VS Code)와 AI 지원을 통해 Stata 워크플로를 어떻게 향상시키는지 확인해 보세요.

데모 프롬프트: "Stata do 파일을 작성하고 실행하되, 모든 경우에 전체 절대 파일 경로를 사용하세요. 자동 데이터세트(webuse auto)를 로드하고 각 변수에 대한 요약 통계를 생성하세요. 데이터세트에서 주요 특징을 식별 및 추출하고, 관련 플롯을 생성하여 plots라는 폴더에 저장하세요. 자동차 가격의 주요 결정 요인을 분석하기 위한 회귀 분석을 수행하세요. 모든 출력을 LaTeX 파일로 내보내고 컴파일하세요. 컴파일 오류는 자동으로 해결하고, LaTeX 컴파일 시간이 10초를 초과하지 않도록 하세요. 모든 코드 오류는 워크플로의 일부로 식별 및 해결되어야 합니다."

다른 Stata 통합을 찾고 계신가요?
Notepad++와 Sublime Text 3에서 Stata를 사용하시나요? 여기를 참조하세요.
이 확장 프로그램을 설치하지 않고도 Claude Desktop에서 Stata MCP를 사용할 수 있나요? 여기를 참조하세요.
Jupyter를 통해 Stata를 사용하시겠습니까? 여기를 참조하세요

요구 사항

컴퓨터에 Stata 17 이상이 설치되어 있습니다.
UV 패키지 관리자(필요한 경우 자동으로 설치되거나 수동으로 설치 가능)

설치

참고: 초기 설치에는 종속성 설정이 필요하며, 완료하는 데 최대 2분 정도 걸릴 수 있습니다. 이 일회성 설정 과정 동안 잠시 기다려 주시기 바랍니다. 이후의 모든 실행은 즉시 시작됩니다.

VS 코드 설치

옵션 1: VS Code Marketplace에서

VS Code Marketplace 에서 직접 이 확장 프로그램을 설치하세요.

지엑스피1

또는:

VS 코드 열기
확장 프로그램 보기로 이동(Ctrl+Shift+X)
"Stata MCP"를 검색하세요
"설치"를 클릭하세요

옵션 2: .vsix 파일에서

릴리스 페이지 에서 확장 패키지 stata-mcp-0.2.1.vsix 를 다운로드하세요.
다음 방법 중 하나를 사용하여 설치하세요.

code --install-extension path/to/stata-mcp-0.2.1.vsix

또는:

VS 코드 열기
확장 프로그램 보기로 이동(Ctrl+Shift+X)
오른쪽 상단의 "..." 메뉴를 클릭하세요
"VSIX에서 설치..."를 선택하세요.
다운로드한 .vsix 파일을 찾아 선택하세요.

커서 설치

릴리스 페이지 에서 확장 패키지 stata-mcp-0.2.2.vsix 를 다운로드하세요.
다음 방법 중 하나를 사용하여 설치하세요.

cursor --install-extension path/to/stata-mcp-0.2.2.vsix

또는:

커서 열기
확장 프로그램 보기로 이동
"..." 메뉴를 클릭하세요
"VSIX에서 설치"를 선택하세요
다운로드한 .vsix 파일을 찾아 선택하세요.

버전 0.1.8부터 이 확장 프로그램은 uv 라는 빠른 Python 패키지 설치 프로그램을 통합하여 환경을 설정합니다. 시스템에서 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 .do 파일 열기
다음을 사용하여 명령을 실행합니다.
- 선택 실행 : Stata 코드를 선택하고 Ctrl+Shift+Enter (Mac에서는 Cmd+Shift+Enter )를 누릅니다.
- 파일 실행 : Ctrl+Shift+D (Mac에서는 Cmd+Shift+D )를 눌러 전체 .do 파일을 실행합니다.
편집기 패널에서 출력 보기

작동 원리

이 확장 기능은 편집기를 Stata에 연결하는 로컬 MCP 서버를 생성하여 다음을 지원합니다.

명령 실행 : Stata 명령을 실행하고 결과를 즉시 확인하세요
컨텍스트 인식 : AI 어시스턴트는 Stata 데이터와 명령을 이해합니다.
향상된 생산성 : 지능형 코드 제안 및 문서 받기

커서 MCP 구성

확장 프로그램은 Cursor MCP 통합을 자동으로 구성합니다. 제대로 작동하는지 확인하려면 다음을 수행하세요.

커서 열기
Ctrl+Shift+P (Mac에서는 Cmd+Shift+P )를 눌러 명령 팔레트를 엽니다.
"Stata: MCP 서버 연결 테스트"를 입력하고 Enter를 누릅니다.
서버가 제대로 연결되면 성공 메시지가 표시됩니다.

커서 구성 파일 경로

커서 MCP 구성 파일의 위치는 운영 체제에 따라 다릅니다.

맥OS :
- 기본 위치: ~/.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

수동 커서 구성

커서 MCP를 수동으로 구성해야 하는 경우:

MCP 구성 파일을 생성하거나 편집합니다.
- macOS/Linux : ~/.cursor/mcp.json
- 윈도우 : %USERPROFILE%\.cursor\mcp.json
Stata MCP 서버 구성을 추가합니다.
{ "mcpServers": { "stata-mcp": { "url": "http://localhost:4000/mcp", "transport": "sse" } } }
파일에 이미 다른 MCP 서버가 포함되어 있는 경우 기존 "mcpServers" 개체에 "stata-mcp" 항목을 추가하기만 하면 됩니다.
파일을 저장하고 Cursor를 다시 시작합니다.

커서 구성 문제 해결

커서가 Stata MCP 서버를 인식하지 못하는 경우:

MCP 서버가 실행 중인지 확인하세요
올바른 내용이 포함된 구성 파일이 있는지 확인하세요.
커서를 다시 시작해 보세요
다른 실행 중인 애플리케이션과 포트 충돌이 없는지 확인하세요.

클라인 MCP 구성

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
- 리눅스 : ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Stata MCP 서버 구성을 추가합니다.
{ "mcpServers": { "stata-mcp": { "url": "http://localhost:4000/mcp", "transport": "sse" } } }
파일에 이미 다른 MCP 서버가 포함되어 있는 경우 기존 "mcpServers" 개체에 "stata-mcp" 항목을 추가하기만 하면 됩니다.
파일을 저장하고 VS Code를 다시 시작합니다.

VS Code 설정을 통해 Cline을 구성할 수도 있습니다.

"cline.mcpSettings": {
  "stata-mcp": {
    "url": "http://localhost:4000/mcp",
    "transport": "sse"
  }
}

클라인 구성 문제 해결

Cline이 Stata MCP 서버를 인식하지 못하는 경우:

MCP 서버가 실행 중인지 확인하세요(상태 표시줄에 "Stata"가 표시되어야 함)
올바른 내용이 포함된 구성 파일이 있는지 확인하세요.
VS Code를 다시 시작해 보세요
오류가 있는지 확장 출력 패널(보기 > 출력 > Stata MCP)을 확인하세요.

Claude Desktop MCP 구성

mcp-proxy를 통해 Claude Desktop에서 이 확장 기능을 사용할 수 있습니다.

Claude Desktop을 구성하기 전에 VS Code 또는 Cursor에 Stata MCP 확장 프로그램이 설치되어 있고 현재 실행 중인지 확인하십시오.
mcp-proxy를 설치하세요:
# Using pip pip install mcp-proxy # Or using uv (faster) uv install mcp-proxy
mcp-proxy 경로를 찾으세요:
# On Mac/Linux which mcp-proxy # On Windows (PowerShell) (Get-Command mcp-proxy).Path
MCP 구성 파일을 편집하여 Claude Desktop을 구성합니다.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단계에서 찾은 실제 경로로 바꾸세요.
Claude Desktop을 다시 시작하세요
Claude Desktop은 사용 가능한 Stata 도구를 자동으로 검색하여 Stata 명령을 실행하고 대화에서 직접 데이터를 분석할 수 있도록 해줍니다.

참고: 이 확장 프로그램을 설치하지 않고도 Claude Desktop에서 Stata MCP를 사용할 수 있는 다른 방법이 있습니다. 여기를 참조하세요.

파이썬 환경 관리

이 확장 기능은 Rust로 제작된 빠른 Python 패키지 설치 프로그램인 uv를 사용하여 Python 종속성을 관리합니다. 주요 기능:

자동 Python 설정 및 종속성 관리
시스템과 충돌하지 않는 격리된 환경을 만듭니다.
Windows, macOS 및 Linux에서 작동합니다.
기존 PIP 설치보다 10~100배 더 빠름

설치 중 UV 관련 오류가 발생하는 경우:

UV를 수동으로 설치하세요:
# 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
문제 해결 단계에 따라 확장 프로그램을 다시 설치하세요.

버전 0.1.8부터 이 확장 프로그램은 빠른 Python 패키지 설치 프로그램인 uv를 통합하여 환경을 설정합니다. 시스템에서 uv를 찾을 수 없는 경우, 확장 프로그램이 자동으로 설치를 시도합니다.

문제 해결

확장 프로그램에 문제가 발생하면 다음 단계에 따라 새로 설치하세요.

윈도우

모든 VS Code/Cursor 창을 닫습니다.
작업 관리자를 엽니다(Ctrl+Shift+Esc):
- "프로세스" 탭으로 이동하세요
- 실행 중인 Python 또는 uvicorn 프로세스를 찾으세요.
- 각각을 선택하고 "작업 종료"를 클릭하세요.
확장 폴더를 제거하세요:
- Win+R을 누르고 %USERPROFILE%\.vscode\extensions 입력한 후 Enter를 누릅니다.
- deepecon.stata-mcp-0.xx 폴더를 삭제합니다(xx는 버전 번호입니다).
- 커서의 경우: 경로는 %USERPROFILE%\.cursor\extensions
UV를 수동으로 설치하세요(필요한 경우):
# Open PowerShell as Administrator and run: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
컴퓨터를 다시 시작하세요(권장하지만 선택 사항)
마켓플레이스에서 최신 버전의 확장 프로그램을 설치하세요

맥OS/리눅스

모든 VS Code/Cursor 창을 닫습니다.
실행 중인 Python 프로세스를 모두 종료합니다.
# Find Python processes ps aux | grep python # Kill them (replace <PID> with the process numbers you found) kill -9 <PID>
확장 폴더를 제거하세요:
# 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
UV를 수동으로 설치하세요(필요한 경우):
# Using curl: curl -LsSf https://astral.sh/uv/install.sh | sh # Or using wget: wget -qO- https://astral.sh/uv/install.sh | sh
터미널이나 컴퓨터를 다시 시작하세요(권장하지만 선택 사항)
마켓플레이스에서 최신 버전의 확장 프로그램을 설치하세요

추가 문제 해결 팁

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 실행 파일을 차단하는지 확인하세요.

GitHub에서 이슈를 열 때 다음을 제공해 주세요.

출력 패널(보기 -> 출력 -> Stata-MCP)의 전체 오류 메시지
귀하의 운영 체제 및 버전
VS 코드/커서 버전
Python 버전( python --version )
UV 버전( uv --version )
문제를 재현하는 단계
관련 로그 파일이나 스크린샷
해당되는 경우 MCP 구성 파일의 내용

자세한 정보는 문제를 더 빨리 파악하고 해결하는 데 도움이 됩니다. GitHub Issues 에서 이슈를 열 수 있습니다.

특허

MIT

크레딧

Lu Han이 제작하고 DeepEcon에서 출판했습니다.

Stata MCP Server

Integrations