mcp-seoul-rtd
서울시 실시간 도시데이터(citydata)를 제공하는 MCP 서버입니다. 서울 주요 121개 장소의 실시간 인구 혼잡도, 도로소통, 주차장, 지하철·버스, 따릉이, 전기차충전소, 날씨, 문화행사, 상권, 사고통제, 재난문자, 뉴스를 조회할 수 있습니다.
Tools
| Tool | 설명 |
|---|---|
list_places |
실시간 도시데이터가 제공되는 121개 장소 목록. query 로 부분 일치 필터 |
get_citydata |
한 장소의 실시간 도시데이터 조회. place 는 장소명(부분 일치)/장소코드, categories 로 섹션 선택 |
categories 값: population, traffic, parking, subway, bus, bike, charger, weather, event, commercial, accident, alert, news
API 키
서울 열린데이터광장에서 인증키를 발급받아 SEOUL_OPEN_API_KEY 환경변수로 전달합니다.
- 샘플키
sample로는 '광화문·덕수궁' 한 곳만 조회할 수 있습니다. - 주의: API 엔드포인트(
openapi.seoul.go.kr:8088)는 평문 HTTP 이며 인증키가 URL 에 포함됩니다.
Claude Code / Claude Desktop 설정
Claude Code 는 CLI 로 등록할 수 있습니다.
claude mcp add seoul-rtd -e SEOUL_OPEN_API_KEY=<발급받은 인증키> -- npx -y mcp-seoul-rtd
기본으로 현재 프로젝트의 local 범위에 저장됩니다. --scope user 를 주면 모든 프로젝트에서, --scope project 를 주면 .mcp.json 파일로 팀과 공유할 수 있습니다. 등록 후 /mcp 로 연결 상태를 확인하세요.
Claude Desktop 은 claude_desktop_config.json (설정 → Developer → Edit Config) 에 아래 블록을 추가합니다.
{
"mcpServers": {
"seoul-rtd": {
"command": "npx",
"args": ["-y", "mcp-seoul-rtd"],
"env": {
"SEOUL_OPEN_API_KEY": "<발급받은 인증키>"
}
}
}
}
개발
pnpm install
pnpm typecheck # 타입 검사
pnpm test # node --test (Node 23.6+ 필요)
pnpm build # tsc → dist/
테스트는 라이브 API 를 호출하지 않고 fixture 와 스텁으로 동작합니다.
릴리즈
main 에 push 되면 GitHub Actions 가 conventional commit 타입으로 버전을 결정해 npm 에 배포합니다. repo secret 에 NPM_TOKEN 이 필요합니다.
라이선스
- 이 패키지의 코드는 MIT 라이선스입니다.
- 제공되는 데이터의 저작권은 서울특별시에 있으며, 공공누리 제1유형(출처표시)에 따라 상업적 이용과 변경이 가능합니다. 데이터를 이용할 때는 출처를 표시해야 합니다. 예: "출처: 서울 열린데이터광장(서울특별시)"
