Map Canvas MCP

ChatGPT와 같은 MCP Apps 호스트를 위한 임베디드 대화형 지도입니다. Worker는 지도 데이터와 안정적인 UI 로더를 반환합니다. 각 도구 결과는 Cloudflare Static Assets에서 제공되는 콘텐츠 주소 지정 Leaflet 번들을 선택하므로 UI 업데이트 시 변경되지 않은 도구 메타데이터를 새로 고칠 필요가 없습니다. 사용자의 브라우저는 표준 타일 서버에서 보이는 OpenStreetMap 타일을 직접 가져옵니다.

프로덕션 엔드포인트

https://map-canvas.android-mxdiego9.workers.dev/mcp

엔드포인트는 공개되어 있으며 인증이 필요하지 않습니다.

Related MCP server: Mapbox MCP Server

로컬 개발

npm install
npm run check
npm run dev

npm run check는 Worker의 타입을 검사하고 초기화, 도구 검색, 도구 실행, 위젯 리소스 로딩에 대한 MCP 스모크 테스트를 실행합니다.

로컬 MCP 엔드포인트는 http://localhost:8787/mcp입니다. MCP Inspector로 테스트하세요:

npx @modelcontextprotocol/inspector@latest

배포

터미널에서 배포:

npm run deploy

API 키가 필요하지 않습니다. 소스나 wrangler.jsonc에 시크릿을 추가하지 마세요. 나중에 인증이 추가되면 Cloudflare 시크릿을 사용하세요.

GitHub Actions로 배포

포함된 워크플로는 main에 푸시할 때마다 배포한 다음 공개 엔드포인트에 대해 프로덕션 MCP 스모크 테스트를 실행합니다. Actions 탭에서 수동으로 실행할 수도 있습니다. 먼저 다음 저장소 Actions 시크릿을 추가하세요:

• CLOUDFLARE_API_TOKEN: 대상 계정에서 Workers를 편집할 수 있는 범위의 토큰

• CLOUDFLARE_ACCOUNT_ID: 대상 Cloudflare 계정 ID

값은 GitHub Actions 시크릿에 유지되며 저장소에 커밋해서는 안 됩니다.

도구

show_map은 십진수 위도/경도 좌표가 있는 1~50개의 장소를 허용합니다. 단순한 호출자는 여전히 connectPlaces를 사용할 수 있습니다. 여행 일정에는 다음도 추가할 수 있습니다:

• 일/날짜 및 시간 라벨과 일 필터링

• 카테고리 및 확정/계획/임시 상태

• 도보, 자동차, 택시, 버스, 철도, 페리, 항공편에 대한 교통 구간

• 개략적인 직선 연결 또는 실제 경로 지오메트리

• 검증된 장소 링크(대체 수단으로 Google Maps 좌표 링크 포함)

위젯은 번호가 매겨진 카테고리 색상 마커, 일정 패널, 보기 재설정 작업, ChatGPT에서의 선택적 전체 화면 프레젠테이션을 사용합니다. 개략적인 구간은 점선으로 표시되고 명시적으로 라벨이 지정되어 턴바이턴 내비게이션으로 오인되지 않습니다.

지도 데이터 © OpenStreetMap 기여자.