oecd-stats-mcp

# OECD Stats MCP OECD SDMX API 기반 MCP 서버. Claude에게 한국어로 물으면 OECD 공식 수치를 출처와 함께 반환. `korean-stats-mcp`(KOSIS)의 구조를 Python으로 옮긴 것. ``` 나: OECD 회원국 중 우리나라 청년실업률 몇 위야? Claude: 2024년 기준 38개국 중 ○위 (○.○%), OECD 평균 대비 -○.○%p 출처: OECD SDMX OECD.SDD.TPS,DSD_LFS@DF_IALFS_UNE_M,1.0 ``` --- ## 설치 — 설정 파일 한 곳만 고치면 끝 Claude Desktop 설정 → 개발자 → 설정 편집 으로 `%APPDATA%\Claude\claude_desktop_config.json`(macOS는 `~/Library/Application Support/Claude/claude_desktop_config.json`)을 열고 `mcpServers`에 아래를 추가한다. ```json { "mcpServers": { "oecd-stats": { "command": "uvx", "args": ["oecd-stats-mcp"] } } } ``` 저장하고 Claude Desktop을 **완전 종료 후 재시작**한다(창만 닫으면 백그라운드에 남으니 트레이 아이콘에서 종료). `uvx`가 격리된 환경에 알아서 받아서 실행하므로 clone도 pip install도 필요 없다. API 키도 필요 없다(OECD 공개 엔드포인트). `uvx`가 없다면 한 번만 설치한다 — [uv](https://docs.astral.sh/uv/) 설치 시 같이 딸려온다. ```powershell irm https://astral.sh/uv/install.ps1 | iex # Windows ``` ```bash curl -LsSf https://astral.sh/uv/install.sh | sh # macOS / Linux ``` 이미 다른 MCP 서버가 등록돼 있으면 `mcpServers` 중괄호 **안쪽에** `"oecd-stats": {...}`만 추가하고 앞 항목 끝에 쉼표를 찍는다. 경로 역슬래시는 두 개(`\\`), 마지막 항목 뒤 쉼표는 금지 — JSON이 깨지면 MCP가 통째로 안 뜬다. ### 잘 되는지 확인 Claude에게 이렇게 물어본다. ``` OECD 회원국 중 우리나라 청년실업률 몇 위야? ``` 안 뜨면 로그를 본다. ```powershell Get-Content $env:APPDATA\Claude\logs\mcp-server-oecd-stats.log -Tail 30 ``` --- ## 개발자용 — 소스에서 실행 지표를 추가하거나 코드를 고칠 사람만 해당된다. ```powershell git clone https://github.com/seongapark/oecd_mcp.git cd oecd_mcp python -m venv .venv .venv\Scripts\python.exe -m pip install -r requirements.txt ``` `activate`가 `PSSecurityException`으로 막히면 activate 없이 `.venv\Scripts\python.exe`를 직접 쓰면 된다. 굳이 쓰려면 그 세션에서만 `Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass`. macOS/Linux는 `source .venv/bin/activate` 후 `pip install -r requirements.txt`. `mcp` 1.x / 2.x 양쪽에서 동작한다. 설정에는 `uvx` 대신 해당 python을 직접 지정한다. ```json { "mcpServers": { "oecd-stats": { "command": "C:\\경로\\oecd_mcp\\.venv\\Scripts\\python.exe", "args": ["-m", "oe…