mcp-seoul-rtd

서울시 실시간 도시데이터(citydata)를 제공하는 MCP 서버입니다. 서울 주요 121개 장소의 실시간 인구 혼잡도, 도로소통, 주차장, 지하철·버스, 따릉이, 전기차충전소, 날씨, 문화행사, 상권, 사고통제, 재난문자, 뉴스를 조회할 수 있습니다.

Tools

| Tool | 설명 | | --- | --- | | list_places | 실시간 도시데이터가 제공되는 121개 장소 목록. query 로 부분 일치 필터 | | get_citydata | 한 장소의 실시간 도시데이터 조회. place 는 장소명(부분 일치)/장소코드, categories 로 섹션 선택 | | get_congestion_ranking | 121개 장소를 현재 혼잡도 순으로 정렬. top 으로 상위 개수(기본 10), category 로 분류 필터 |

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": "<발급받은 인증키>"
      }
    }
  }
}

라이선스

• 이 패키지의 코드는 MIT 라이선스입니다.
• 제공되는 데이터의 저작권은 서울특별시에 있으며, 공공누리 제1유형(출처표시)에 따라 상업적 이용과 변경이 가능합니다. 데이터를 이용할 때는 출처를 표시해야 합니다. 예: "출처: 서울 열린데이터광장(서울특별시)"
• 모든 tool 의 출력에는 위 출처표시 줄이 자동으로 포함됩니다.