Skip to main content
Glama

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

Related MCP server: Seoul Mobility Advisor

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 의 출력에는 위 출처표시 줄이 자동으로 포함됩니다.

Available Tools

3 tools
get_citydata실시간 도시데이터A
Read-only

서울 주요 장소 한 곳의 실시간 도시데이터를 조회합니다. 인구 혼잡도, 도로소통, 주차장, 지하철, 버스, 따릉이, 전기차충전소, 날씨, 문화행사, 상권, 사고통제, 재난문자, 뉴스를 제공합니다. categories 로 필요한 데이터만 고르면 출력이 줄어듭니다.

Inputs: place (required), categories.

get_congestion_ranking혼잡도 순위A
Read-only

서울 주요 121개 장소를 현재 혼잡도(붐빔 > 약간 붐빔 > 보통 > 여유) 순으로 정렬해 반환합니다. "지금 가장 붐비는 곳이 어디야?" 같은 질문에 사용하세요. category 로 분류를 좁힐 수 있습니다.

Inputs: top, category.

list_places장소 목록A
Read-only

서울시 실시간 도시데이터가 제공되는 주요 121개 장소를 나열합니다. query 로 장소명을 부분 일치 필터링할 수 있습니다.

Inputs: query.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool serves a distinct purpose: listing available places, fetching detailed data for a single place, and comparing congestion across places. There is no overlap in their primary functions.

    Naming Consistency5/5

    All tool names follow the same verb_noun pattern with lowercase and underscores: list_places, get_citydata, get_congestion_ranking. This is highly predictable and consistent.

    Tool Count5/5

    Three tools is a minimal but well-scoped set for a real-time Seoul city data server. Each tool covers a necessary aspect: enumeration, retrieval, and ranking, with no redundancy.

    Completeness5/5

    The toolset fully covers the domain of accessing real-time city data: listing available places, retrieving detailed data by place with optional category filtering, and obtaining a congestion ranking across all places. There are no obvious gaps for its intended purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers