DragonMCP: 홍콩 날씨, MTR, 국경 공공 데이터 조회

누구에게 맞나

에이전트가 홍콩과 내지 국경 일대의 실시간 공공 데이터를 조회하게 하고 싶고, 여러 개방 인터페이스를 직접 붙이고 싶지 않다면 이 서비스가 맞습니다. 공식은 에이전트용 MCP 서버로 적어 검증 가능한 공공 데이터를 제공합니다.

이미 Node.js 18 이상이 설치되어 있고, 저장소를 로컬에 복제한 뒤 node로 stdio 프로세스를 실행할 수 있는 사람에게 맞습니다. 홍콩 도구는 .env가 필요 없습니다. 고덕(Amap) 관련 도구를 쓰려면 공식은 템플릿을 복사한 뒤 비밀키를 채우라고 합니다. 첫 시도에서는 그 경로를 가지 말고, 비밀키가 필요 없는 홍콩 도구부터 쓰세요.

오프라인 자료고가 아닙니다. 각 도구는 온라인 인터페이스를 호출하며 mock이 없습니다. 업스트림을 쓸 수 없으면 도구가 바로 설명하고, 그럴듯한 답을 지어내지 않습니다.

3분 만에 첫 시도를 끝내기

공식 권장 경로는 로컬 복제 후 빌드입니다. 전제 조건: 이 기기의 Node.js 18 이상. 홍콩 날씨 조회에는 환경 변수가 필요 없습니다.

공식 단계를 실행하세요.

git clone https://github.com/arthurpanhku/DragonMCP.git
cd DragonMCP
npm install
npm run build

빌드가 끝나면 MCP 클라이언트에서 command를 node로 두고, args를 이 기기 저장소의 dist/stdio.js로 향하게 하세요. 공식 예는 절대 경로 자리 표시를 씁니다. 복제 후의 실제 경로로 바꾸고 자리 표시 디렉터리를 그대로 복사하지 마세요. 저장한 뒤 클라이언트를 다시 불러오고 서비스가 연결되었는지 확인하세요.

그다음 읽기 전용 조회를 한 번 합니다. hk_weather_current를 호출하세요. 공식 표는 홍콩 천문대에 연결하며 현재 날씨와 유효 경보용이라고 명시합니다. 표는 매개변수 필드를 쓰지 않았습니다. 클라이언트가 보여주는 도구 정의대로 호출하고, 정류장 번호나 등장하지 않은 매개변수를 스스로 만들지 마세요.

성공 신호: 현재 날씨와 유효 경보가 반환됩니다. 업스트림을 쓸 수 없으면 날씨를 지어내지 않고 도구가 설명합니다. system_run_selftest를 다시 호출할 수도 있습니다. 각 업스트림을 탐지하고 지금 어디가 도달 가능한지 보고합니다. 이는 공식이 준 검증 방식이며 첫 시도 필수 항목은 아닙니다.

사용 사례

사례 1: 홍콩 현재 날씨와 경보를 조회합니다. hk_weather_current를 호출하세요. 공식은 홍콩 천문대에 연결하고 Current conditions + active warnings를 반환한다고 명시합니다. 필드 표나 예시 정류장은 없습니다. 성공 시 현재 상황과 유효 경보가 보여야 하며, 오프라인 캐시가 아니라 실시간 인터페이스 결과로 보세요.

사례 2: MTR 여정과 도착 조회. search_mtr_schedule을 호출하세요. 공식은 데이터가 data.gov.hk에서 오며, 환승 여정 계획과 실시간 도착용이고 전체 10개 노선, 98개 역을 덮는다고 명시합니다. 공식은 출발지와 도착지를 어떻게 넘기는지 쓰지 않았습니다. 클라이언트가 보여주는 필드만 쓰세요. 성공 시 여정 또는 도착 정보가 보여야 합니다. 시각표를 바꿀 수 있다고 이해하지 마세요.

같은 페이지는 hk_typhoon_signal도 지목합니다. 태풍, 폭우, 기타 유효 경보의 구조화 상태용이며 역시 홍콩 천문대에 연결합니다. 첫 시도에 호출할 필요는 없습니다.

사용 경계

전제는 Node.js 18+입니다. 홍콩 도구는 .env가 필요 없습니다. 고덕 도구는 공식 템플릿대로 비밀키를 채워야 하며, 이 페이지는 비밀키 변수 이름을 쓰지 않았습니다. 첫 시도에서 추측하지 마세요. 각 도구는 온라인 인터페이스를 치고 외부 네트워크로 나가며, 조회한 노선이나 날씨 주제도 드러낼 수 있습니다.

공식은 속도 제한, 할당량, 캐시 유효기간을 쓰지 않았습니다. 업스트림이 죽으면 도구가 설명합니다. system_run_selftest로 각 업스트림 도달 여부를 탐지할 수 있습니다. 공식은 실행 취소나 롤백을 주지 않습니다. 이 조회는 읽기 전용 공공 데이터이지만 위험 제로는 아닙니다.

설정의 dist/stdio.js는 이 기기의 빌드 산출물을 가리켜야 합니다. 빌드하지 않은 소스 경로를 쓰지 말고, 지목되지 않은 내지 도구 이름도 지어내지 마세요.