서울대중교통(교통약자편) — 교통약자 대중교통 MCP

카카오 PlayMCP 개발 공모전(MCP Player 10, 2회차) 출품작. 서울 지하철/버스를 교통약자(휠체어·시각장애·고령자·유아동반) 관점에서 "실제로 이용 가능한지"까지 판단해 안내하는 Remote MCP 서버입니다.

핵심 가치

일반 지도앱은 최단경로만 알려주지만, 교통약자에게 진짜 문제는 "이 경로가 나에게 실제로 가능한가" 입니다. 이 MCP는 엘리베이터 실시간 고장·열차 지연/배차조정을 감지해 선제 경고하고, 저상버스·콜택시 대안을 스스로 제시하며, 수유실·기저귀교환대 같은 육아 편의시설까지 안내합니다.

Related MCP server: seoul-essentials

툴 구성 (4개)

상세 스펙: docs/API_SPEC.md

로컬 실행

python -m venv .venv
.venv/Scripts/pip install -r requirements.txt   # (mac/linux: .venv/bin/pip)
cp .env.example .env                            # 키 없어도 샘플 데이터로 동작
.venv/Scripts/python server.py                  # http://0.0.0.0:8000/mcp

키(.env)가 없으면 샘플 데이터로 동작하므로 MCP Inspector로 즉시 테스트할 수 있습니다.

MCP Inspector 점검

npx @modelcontextprotocol/inspector
# Transport: Streamable HTTP / URL: http://127.0.0.1:8000/mcp

PlayMCP 요건 준수

• ✅ Streamable HTTP, Stateless, Remote(배포 시 공개 URL)

• ✅ protocolVersion 2025-03-26 (요건 범위 내)

• ✅ 툴 4개, 각 툴 annotations 5개 값 모두 지정

• ✅ 서버명/툴명에 "kakao" 미포함

• ✅ description 영문 + 서비스명 영문/국문 병기

• ✅ 응답은 정제된 마크다운, 캐싱/타임아웃으로 응답속도 확보

배포 (Render 예시)

• Build: pip install -r requirements.txt

• Start: python server.py (PORT 자동 주입)

• 배포 후 공개 URL https://<app>.onrender.com/mcp 를 PlayMCP에 등록