🇸🇬 Singapore MCP

싱가포르 공공 데이터 및 서비스를 위한 오픈소스 Model Context Protocol 서버입니다.

싱가포르에서 Olano가 구축하고 유지 관리합니다.

이 프로젝트는 독립적인 커뮤니티 프로젝트입니다. 싱가포르 정부 또는 정부 기관과 제휴, 보증, 공식 제품이 아닙니다.

패키지

모든 패키지는 로컬 stdio 및 Streamable HTTP 전송을 지원합니다.

Related MCP server: Gahmen MCP Server

빠른 시작

stdio를 통해 전체 싱가포르 제품군을 실행합니다:

npx @olano/mcp-singapore

또는 특정 서버를 실행합니다:

npx @olano/mcp-onemap
npx @olano/mcp-weather

Streamable HTTP를 통해 통합 서버를 실행합니다:

npx @olano/mcp-singapore --transport http --host 127.0.0.1 --port 3000

MCP 엔드포인트는 http://127.0.0.1:3000/mcp입니다. 기본 바인드 주소는 localhost입니다. 인터넷에 노출되는 배포에는 인증 및 TLS를 적용하세요.

클라이언트 구성

일반적인 mcpServers JSON 형식을 지원하는 클라이언트에 통합 서버를 추가합니다:

{
  "mcpServers": {
    "singapore": {
      "command": "npx",
      "args": ["-y", "@olano/mcp-singapore"],
      "env": {
        "DATA_GOV_SG_API_KEY": "optional-data-gov-key",
        "ONEMAP_TOKEN": "your-onemap-token",
        "LTA_DATAMALL_API_KEY": "optional-lta-account-key"
      }
    }
  }
}

사용하지 않는 환경 변수를 제거하세요. 실제 자격 증명을 커밋하지 마세요.

도구

도구 이름은 네임스페이스로 구분되며 안정적입니다:

• datagov_list_datasets, datagov_get_dataset_metadata, datagov_list_dataset_rows

• datagov_get_realtime

• onemap_search, onemap_reverse_geocode, onemap_route

• lta_bus_arrivals, lta_list_bus_stops, lta_traffic_incidents

• lta_traffic_images, lta_carpark_availability, lta_taxi_availability

• weather_two_hour_forecast, weather_twenty_four_hour_forecast

• weather_four_day_outlook, weather_temperature, weather_rainfall, weather_air_quality

• singapore_location_brief

서버는 읽기 전용입니다. 입력은 Zod로 검증되며, 업스트림 출처와 API 경로는 코드에 고정되어 있고, 요청에는 타임아웃과 응답 크기 제한이 있으며, 일시적인 요청은 재시도되고, GET 응답은 짧게 캐시됩니다. 업스트림 호출은 공공 서비스에 대한 버스트를 방지하기 위해 공급자 클라이언트별로 시작 속도가 제한됩니다.

자격 증명

LTA 동적 API는 등록이 필요합니다. OneMap API는 OneMap 계정과 토큰이 필요합니다. 공개 data.gov.sg 실시간 엔드포인트는 키 없이 테스트할 수 있지만, 프로덕션 사용자는 키를 받아야 합니다.

데이터 소스 및 출처 표시

• data.gov.sg API guide

• OneMap API documentation

• LTA DataMall

• Meteorological Service Singapore

• Singapore Open Data Licence

API 가용성, 데이터 정확성, 속도 제한 및 업스트림 약관은 각 제공업체가 관리합니다. 반환된 데이터를 사용하는 애플리케이션은 관련 소스 약관 및 출처 표시 요구 사항을 준수해야 합니다.

개발

npm install
npm run format:check
npm run lint
npm test
npm run build

대화형 테스트에는 공식 MCP Inspector를 사용하세요:

npx @modelcontextprotocol/inspector node packages/singapore/dist/cli.js

Architecture, Contributing, Security를 참조하세요.

로드맵

• 문서화된 공공 데이터셋을 기반으로 한 HDB 및 URA 전용 패키지

• 데이터셋 약관 및 실용적인 페이지네이션에 따른 ACRA 공개 기업 데이터 검색

• 더 많은 기관 간 지역, 이동성 및 비즈니스 위치 도구

• 호스팅된 인증 엔드포인트 및 MCP 레지스트리 게시

• 싱가포르 통계청 공식 MCP를 복제하지 않고 SingStat 상호 운용성

라이선스

소스 코드는 MIT 라이선스로 배포됩니다. 정부 데이터는 각 소스 기관이 게시한 라이선스 및 약관의 적용을 받습니다.