Mapbox

ทางการ

ปลดล็อกความสามารถด้านภูมิสารสนเทศผ่าน Mapbox APIs เช่น การระบุพิกัดทางภูมิศาสตร์ การค้นหาจุดสนใจ การนำทาง เส้นเวลาเดินทาง และอื่นๆ

คุณทำอะไรได้บ้างด้วย Mapbox MCP?

  • ค้นหาและระบุตำแหน่งสถานที่ — สอบถามที่อยู่ จุดสนใจ หรือสถานที่สำคัญผ่าน search_and_geocode_tool พร้อมการกรองตามหมวดหมู่และการรองรับภาษา
  • รับเส้นทางแบบเลี้ยวต่อเลี้ยว — ขอเส้นทางสำหรับการขับขี่ การเดิน หรือการปั่นจักรยาน พร้อมข้อมูลจราจรสด จุดแวะพัก และการยกเว้นผ่าน directions_tool
  • แสดงผลบนแผนที่สด — ใช้ render_map_tool เพื่อแสดงเส้นทาง ผลการค้นหา หรือ GeoJSON ที่กำหนดเองเป็นแผนที่แบบโต้ตอบในแชท
  • คำนวณเชิงพื้นที่แบบออฟไลน์ — คำนวณระยะทาง พื้นที่ ทิศทาง พื้นที่รอบจุด และจุดศูนย์กลางในเครื่องด้วยเครื่องมือเช่น distance_tool และ buffer_tool โดยไม่ต้องเรียกใช้ API
  • ปรับตำแหน่ง GPS ให้ตรงกับถนน — ทำความสะอาดพิกัดที่มีสัญญาณรบกวนและจับคู่กับเครือข่ายถนนโดยใช้ map_matching_tool พร้อมการระบุเวลาแบบไม่บังคับ
  • ปรับเส้นทางหลายจุดให้เหมาะสม — แก้ปัญหาพนักงานขายเดินทางสำหรับสถานที่สูงสุด 12 แห่งด้วย optimization_tool รองรับการเดินทางแบบไปกลับหรือเที่ยวเดียว

เอกสาร

Mapbox MCP Server

npm version

เซิร์ฟเวอร์ Node.js ที่ใช้ Model Context Protocol (MCP) สำหรับ Mapbox APIs

ปลดล็อกความฉลาดเชิงพื้นที่สำหรับแอปพลิเคชัน AI ของคุณ

Mapbox MCP Server เปลี่ยนเอเจนต์หรือแอปพลิเคชัน AI ใดๆ ให้เป็นระบบที่ตระหนักรู้เชิงพื้นที่ โดยให้การเข้าถึงแพลตฟอร์มข้อมูลตำแหน่งที่ครอบคลุมของ Mapbox ได้อย่างราบรื่น ด้วยเซิร์ฟเวอร์นี้ AI ของคุณสามารถเข้าใจและให้เหตุผลเกี่ยวกับสถานที่ นำทางในโลกทางกายภาพ และเข้าถึงข้อมูลเชิงพื้นที่ที่หลากหลาย รวมถึง:

  • การจีโอโค้ดทั่วโลก เพื่อแปลงที่อยู่และชื่อสถานที่เป็นพิกัดและในทางกลับกัน
  • การค้นหาจุดสนใจ (POI) ทั่วธุรกิจ สถานที่สำคัญ และสถานที่ต่างๆ นับล้านทั่วโลก
  • การกำหนดเส้นทางหลายรูปแบบ สำหรับการขับขี่ การเดิน และการปั่นจักรยาน พร้อมการจราจรแบบเรียลไทม์
  • เมทริกซ์เวลาการเดินทาง เพื่อวิเคราะห์การเข้าถึงและเพิ่มประสิทธิภาพโลจิสติกส์
  • การเพิ่มประสิทธิภาพเส้นทาง เพื่อค้นหาลำดับการเยี่ยมชมที่เหมาะสมที่สุดสำหรับจุดแวะหลายจุด (ปัญหาพนักงานขายเดินทาง)
  • การจับคู่แผนที่ เพื่อจัดแนวร่องรอย GPS ให้เข้ากับเครือข่ายถนนสำหรับการแสดงเส้นทางที่สะอาด
  • การสร้างไอโซโครน เพื่อแสดงภาพพื้นที่ที่สามารถเข้าถึงได้ภายในข้อจำกัดด้านเวลาหรือระยะทางที่กำหนด
  • การแสดงแผนที่แบบโต้ตอบสด (render_map_tool) เพื่อแสดงเส้นทาง ผลการค้นหา และ GeoJSON ที่กำหนดเองของคุณบนแผนที่ Mapbox GL JS จริงภายในแชทโดยตรง
  • ภาพแผนที่แบบคงที่ เพื่อสร้างการแสดงภาพของสถานที่ เส้นทาง และข้อมูลทางภูมิศาสตร์
  • การคำนวณเชิงพื้นที่แบบออฟไลน์ สำหรับระยะทาง พื้นที่ ทิศทาง บัฟเฟอร์ และการวิเคราะห์เชิงพื้นที่โดยไม่ต้องเรียก API

ไม่ว่าคุณจะสร้างผู้ช่วยท่องเที่ยว AI ตัวเพิ่มประสิทธิภาพโลจิสติกส์ ระบบแนะนำตามตำแหน่ง หรือแอปพลิเคชันใดๆ ที่ต้องเข้าใจ "ที่ไหน" Mapbox MCP Server ก็ให้ความฉลาดเชิงพื้นที่ที่ทำให้เป็นไปได้ คุณยังสามารถเปิดใช้งานบนไคลเอนต์ยอดนิยม เช่น Claude Desktop และ VS Code ได้อีกด้วย ดูรายละเอียดด้านล่าง

Mapbox MCP Server Demo

การใช้งาน

ต้องใช้โทเค็นการเข้าถึง Mapbox เพื่อใช้ MCP เซิร์ฟเวอร์นี้

ปลายทาง MCP ที่โฮสต์

สำหรับการเข้าถึงที่รวดเร็ว คุณสามารถใช้ปลายทาง MCP ที่โฮสต์ของเรา:

ปลายทาง: https://mcp.mapbox.com/mcp

สำหรับคำแนะนำการตั้งค่าโดยละเอียดสำหรับไคลเอนต์ต่างๆ และการใช้งาน API ดู คู่มือเซิร์ฟเวอร์ MCP ที่โฮสต์

วิธีรับโทเค็นการเข้าถึง Mapbox:

  1. ลงทะเบียนบัญชี Mapbox ฟรีที่ mapbox.com/signup
  2. ไปที่ หน้าบัญชี ของคุณ
  3. สร้างโทเค็นใหม่หรือใช้โทเค็นสาธารณะเริ่มต้น

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับโทเค็นการเข้าถึง Mapbox ดู เอกสาร Mapbox เกี่ยวกับโทเค็นการเข้าถึง

คู่มือการผสานรวม

สำหรับคำแนะนำการตั้งค่าโดยละเอียดสำหรับการผสานรวมต่างๆ โปรดดูคู่มือต่อไปนี้:

  • การตั้งค่า Claude Desktop - คำแนะนำในการกำหนดค่า Claude Desktop ให้ทำงานกับ MCP เซิร์ฟเวอร์นี้
  • การตั้งค่า Goose - การตั้งค่าเฟรมเวิร์กเอเจนต์ AI Goose
  • การตั้งค่า VS Code - การตั้งค่าสภาพแวดล้อมการพัฒนาใน Visual Studio Code
  • การตั้งค่า Cursor AI IDE - การตั้งค่าสภาพแวดล้อมการพัฒนาใน Cursor AI IDE
  • การผสานรวม Smolagents - ตัวอย่างการเชื่อมต่อเอเจนต์ AI Smolagents กับเครื่องมือของ Mapbox
  • การนำเข้าเครื่องมือโดยตรง - ใช้เครื่องมือ Mapbox ในแอปพลิเคชันของคุณเองโดยไม่ต้องรัน MCP เซิร์ฟเวอร์
  • คู่มือ render_map_tool - พรีมิทีฟการแสดงแผนที่: โครงสร้างเพย์โหลดแบบเต็มและวิธีแสดงข้อมูลของคุณเองแบบสแตนด์อโลน โดยไม่ต้องใช้เครื่องมือ Mapbox อื่นใด
  • Elicitations - วิธีที่ search_and_geocode_tool และ directions_tool ถามผู้ใช้เพื่อแยกแยะผลลัพธ์หรือเลือกเส้นทาง และวิธีที่พวกมันลดระดับอย่างสง่างามเมื่อไคลเอนต์ไม่รองรับ

ตัวอย่างพรอมต์

ลองใช้พรอมต์เหล่านี้กับ Claude Desktop หรือไคลเอนต์ MCP อื่นๆ หลังการตั้งค่า:

การระบุตำแหน่ง

สำหรับคำสั่งที่เน้นพิกัดเป็นหลัก — "อะไรอยู่ใกล้ฉัน", "นี่คือย่านอะไร", "อะไรที่เข้าถึงได้ภายใน N นาที" — ใช้ ground_location_tool มันรวม reverse geocoding การค้นหาหมวดหมู่ และ isochrone ในการเรียกครั้งเดียว โดยเลือกกลยุทธ์ที่เหมาะสมตามคำสั่งโดยอัตโนมัติ และส่งคืนระเบียนแบบมีชนิด (ชื่อ ที่อยู่ พิกัด ระยะทาง รูปหลายเหลี่ยมการเข้าถึง) พร้อมการอ้างอิง

พรอมต์สี่ข้อด้านล่างแต่ละข้อใช้กลยุทธ์ที่แตกต่างกันในการเรียกเครื่องมือครั้งเดียว:

  • ย่าน"47.6097, -122.3408 อยู่ในย่านอะไร และมีอะไรอยู่รอบตัวฉันบ้าง?"
  • POI"ร้านกาแฟภายในระยะเดิน 10 นาทีจาก 40.7580, -73.9855"
  • ภูมิภาค"ฉันสามารถไปถึงอะไรได้ภายในเดิน 15 นาทีจาก 37.7749, -122.4194?"
  • การกำหนดเส้นทาง"จุดที่สามารถเดินทางไปถึงได้ใกล้ที่สุดเพื่อไปส่งใครสักคนที่ 34.0522, -118.2437"

การค้นพบสถานที่

  • "ค้นหาร้านกาแฟภายในระยะเดินจาก Empire State Building"
  • "ฉันต้องการเดินทางจาก Seattle ไป Portland มี Starbucks ระหว่างทางไหม?"
  • "แสดงปั๊มน้ำมันตามเส้นทางจาก Boston ไป New York"
  • "มีร้านอาหารอะไรใกล้ Times Square บ้าง?"

การนำทางและการเดินทาง

  • "ขอเส้นทางขับรถจาก LAX ไป Hollywood พร้อมการจราจรปัจจุบัน"
  • "ใช้เวลาเดินจาก Central Park ไป Times Square นานเท่าไร?"
  • "คำนวณเวลาการเดินทางจากโรงแรมของฉัน (Four Seasons) ไปสนามบิน JFK โดยแท็กซี่ในช่วงชั่วโมงเร่งด่วน"

การแสดงภาพและแผนที่

  • "ใช้เครื่องมือแสดงแผนที่ Mapbox แสดงเส้นทางจาก Golden Gate Bridge ไป Union Square ในซานฟรานซิสโก" — แสดงเส้นทางแบบโต้ตอบสดบนแผนที่ Mapbox จริง
  • "สร้างภาพแผนที่แสดงเส้นทางจาก Golden Gate Bridge ไป Fisherman's Wharf พร้อมเครื่องหมายที่ทั้งสองตำแหน่ง"
  • "แสดงมุมมองดาวเทียมของแมนฮัตตันพร้อมทำเครื่องหมายสถานที่สำคัญ"
  • "สร้างแผนที่เน้นตำแหน่ง Starbucks ทั้งหมดภายในหนึ่งไมล์จากใจกลางเมืองซีแอตเทิล"
  • "แสดงรูปหลายเหลี่ยมเติมทับพิกัดเหล่านี้: [...] พร้อมเครื่องหมายที่ระบุว่า 'คลังสินค้า' ที่ [...]" — แสดง GeoJSON ของคุณเองโดยตรงผ่าน render_map_tool โดยไม่ต้องใช้เครื่องมือ Mapbox อื่น

การวิเคราะห์และการวางแผน

  • "แสดงพื้นที่ที่สามารถเข้าถึงได้ภายใน 30 นาทีจากใจกลางเมืองพอร์ตแลนด์โดยรถยนต์"
  • "คำนวณเมทริกซ์เวลาการเดินทางระหว่างโรงแรม 3 แห่งนี้ (Marriott, Sheraton และ Hilton) กับศูนย์ประชุมในเดนเวอร์"
  • "ค้นหาเส้นทางที่เหมาะสมที่สุดในการเยี่ยมชมสถานที่ท่องเที่ยว 3 แห่งนี้ (Golden Gate, Musical Stairs และ Fisherman's Wharf) ในซานฟรานซิสโก"
  • "เพิ่มประสิทธิภาพเส้นทางการจัดส่งสำหรับ 8 ที่อยู่นี้: [รายการที่อยู่]"

GPS และการจับคู่เส้นทาง

  • "ทำความสะอาดร่องรอย GPS นี้และแสดงเส้นทางจริงบนถนน: [รายการพิกัดพร้อมเวลา]"
  • "จัดแนวการปั่นจักรยานที่บันทึกไว้นี้เข้ากับเครือข่ายการปั่นจักรยาน: [พิกัด GPS]"
  • "จับคู่เส้นทางการขับขี่นี้กับเครือข่ายถนนและแสดงระดับความแออัดของการจราจร"

การคำนวณเชิงพื้นที่แบบออฟไลน์

  • "ระยะทางระหว่างสองพิกัดนี้เป็นไมล์เท่าไร?"
  • "คำนวณพื้นที่ของรูปหลายเหลี่ยมนี้เป็นตารางกิโลเมตร"
  • "จุดที่ 37.7749°N, 122.4194°W อยู่ภายในรูปหลายเหลี่ยมพื้นที่บริการนี้หรือไม่?"
  • "ทิศทางจากซานฟรานซิสโกไปนิวยอร์กคือเท่าไร?"
  • "หาจุดกึ่งกลางระหว่างลอนดอนและปารีส"
  • "สร้างเขตบัฟเฟอร์ 5 ไมล์รอบตำแหน่งนี้"
  • "คำนวณเซนทรอยด์ของขอบเขตย่านนี้"
  • "กล่องขอบเขตสำหรับพิกัดเส้นทางเหล่านี้คืออะไร?"
  • "ทำให้รูปหลายเหลี่ยมที่ซับซ้อนนี้ง่ายขึ้นเพื่อลดจำนวนจุด"

เคล็ดลับเพื่อผลลัพธ์ที่ดีขึ้น

  • ระบุตำแหน่งให้เฉพาะเจาะจง (ใช้ที่อยู่เต็มหรือชื่อสถานที่สำคัญ)
  • ระบุวิธีการเดินทางที่คุณต้องการ (ขับรถ เดิน ปั่นจักรยาน)
  • รวมข้อจำกัดด้านเวลาเมื่อเกี่ยวข้อง ("ในช่วงชั่วโมงเร่งด่วน", "เวลา 15:00 น.")
  • ขอรูปแบบเอาต์พุตเฉพาะเมื่อจำเป็น ("เป็นภาพแผนที่", "ในรูปแบบ JSON")

ตัวอย่างโดยละเอียด: ดู examples/search-along-route.md สำหรับตัวอย่างที่ครอบคลุมของพรอมต์ค้นหาตามเส้นทางพร้อมกรณีการใช้งานต่างๆ และคำแนะนำการทดสอบ MCP Inspector

ทรัพยากร

MCP เซิร์ฟเวอร์เปิดเผยข้อมูลอ้างอิงแบบคงที่เป็น ทรัพยากร MCP ทรัพยากรให้การเข้าถึงแบบอ่านอย่างเดียวกับข้อมูลที่ไคลเอนต์สามารถอ้างอิงได้โดยตรงโดยไม่ต้องเรียกเครื่องมือ

ทรัพยากรที่มี

ทรัพยากรหมวดหมู่ Mapbox

รูปแบบ URI: mapbox://categories หรือ mapbox://categories/{language}

เข้าถึงรายการ ID หมวดหมู่ที่พร้อมใช้งานทั้งหมดสำหรับใช้กับเครื่องมือค้นหาหมวดหมู่ หมวดหมู่สามารถใช้กรองผลการค้นหาตามประเภท (เช่น "ร้านอาหาร", "โรงแรม", "ปั๊มน้ำมัน")

ตัวอย่าง:

  • mapbox://categories - รายการหมวดหมู่เริ่มต้น (ภาษาอังกฤษ)
  • mapbox://categories/ja - ชื่อหมวดหมู่ภาษาญี่ปุ่น
  • mapbox://categories/es - ชื่อหมวดหมู่ภาษาสเปน

การเข้าถึงทรัพยากร:

  • ไคลเอนต์ที่รองรับทรัพยากร MCP โดยกำเนิด: ใช้เมธอดโปรโตคอล MCP resources/read
  • ไคลเอนต์ที่ไม่รองรับทรัพยากร: ใช้ resource_reader_tool กับ URI ของทรัพยากร

ตัวอย่างแผนที่แบบสมบูรณ์ (render_map_tool)

เครื่องมือเชิงพื้นที่ทุกตัวในเซิร์ฟเวอร์นี้ (เส้นทาง isochrone การค้นหา และอื่นๆ) สามารถแสดงผลลัพธ์เป็นแผนที่ Mapbox GL JS แบบโต้ตอบสดผ่าน render_map_tool — พรีมิทีฟการแสดงผลเดียวของเซิร์ฟเวอร์ มันแสดงผลผ่านโปรโตคอล MCP Apps (@modelcontextprotocol/ext-apps) เป็นแผง HTML แบบสแตนด์อโลนภายในแชทโดยตรง พร้อมปุ่มสลับเต็มหน้าจอ ในไคลเอนต์ที่รองรับ:

  • Claude Desktop
  • VS Code with GitHub Copilot
  • Claude Code
  • Goose

คุณไม่จำเป็นต้องใช้เครื่องมืออื่นใดของเซิร์ฟเวอร์นี้เพื่อใช้มัน render_map_tool ยังยอมรับ GeoJSON ที่ประกอบด้วยมือโดยตรง — รูปหลายเหลี่ยม เครื่องหมาย และเส้นทางของคุณเอง — โดยไม่ต้องพึ่งพา directions_tool, isochrone_tool หรือการเรียก API Mapbox อื่นใด ดู คู่มือ render_map_tool ฉบับเต็ม สำหรับโครงสร้างเพย์โหลดและตัวอย่างสแตนด์อโลนที่สมบูรณ์

หากคุณต้องการภาพคงที่ที่รับประกันได้ในไคลเอนต์ที่ไม่รองรับ MCP Apps ให้ใช้ static_map_image_tool แทน — มันส่งคืน PNG/JPEG ที่เข้ารหัส base64 ซึ่งทุกไคลเอนต์สามารถแสดงได้

CLIENT_NEEDS_RESOURCE_FALLBACK

เครื่องมือสำรองทรัพยากร (เลือกใช้สำหรับไคลเอนต์ที่ไม่เป็นไปตามข้อกำหนด)

ทรัพยากรเป็นคุณสมบัติหลักของ MCP ที่ไคลเอนต์ส่วนใหญ่รองรับ (Claude Desktop, VS Code, MCP Inspector ฯลฯ) อย่างไรก็ตาม ไคลเอนต์บางตัว (เช่น smolagents) ไม่รองรับทรัพยากรเลย สำหรับไคลเอนต์เหล่านี้ เซิร์ฟเวอร์สามารถให้ "เครื่องมือสำรองทรัพยากร" ที่ส่งเนื้อหาเดียวกันกับทรัพยากรแต่ผ่านการเรียกเครื่องมือ

เครื่องมือสำรอง:

  • resource_reader_tool - การสำรองทั่วไปสำหรับการอ่านทรัพยากรใดๆ ตาม URI
  • category_list_tool - ให้การเข้าถึงรายการหมวดหมู่ (mapbox://categories)

โดยค่าเริ่มต้น เครื่องมือเหล่านี้จะไม่รวมอยู่ (ถือว่าไคลเอนต์ของคุณรองรับทรัพยากร) หากไคลเอนต์ของคุณไม่รองรับทรัพยากร ให้เปิดใช้งานเครื่องมือสำรอง:

export CLIENT_NEEDS_RESOURCE_FALLBACK=true

เมื่อใดควรตั้งค่านี้:

  • ✅ ตั้งเป็น true หากใช้ smolagents หรือไคลเอนต์อื่นที่ไม่รองรับทรัพยากร
  • ❌ ปล่อยว่างไว้ (ค่าเริ่มต้น) หากใช้ Claude Desktop, VS Code, MCP Inspector หรือไคลเอนต์ที่รองรับทรัพยากรใดๆ
  • ❌ ปล่อยว่างไว้หากไม่แน่ใจ (ไคลเอนต์ส่วนใหญ่รองรับทรัพยากร)

เครื่องมือ

เครื่องมืออรรถประโยชน์

เครื่องมืออ่านทรัพยากร

ให้การเข้าถึงทรัพยากร MCP สำหรับไคลเอนต์ที่ไม่รองรับ API ทรัพยากร MCP โดยกำเนิด ใช้เครื่องมือนี้เพื่ออ่านทรัพยากร เช่น รายการหมวดหมู่

พารามิเตอร์:

  • uri: URI ของทรัพยากรที่จะอ่าน (เช่น mapbox://categories, mapbox://categories/ja)

ตัวอย่างการใช้งาน:

  • อ่านหมวดหมู่เริ่มต้น: {"uri": "mapbox://categories"}
  • อ่านหมวดหมู่ภาษาญี่ปุ่น: {"uri": "mapbox://categories/ja"}

หมายเหตุ: หากไคลเอนต์ MCP ของคุณรองรับทรัพยากรโดยกำเนิด ควรใช้ API ทรัพยากรโดยตรงเพื่อประสิทธิภาพที่ดีกว่า

เครื่องมือเชิงพื้นที่แบบออฟไลน์

เครื่องมือเหล่านี้ทำการคำนวณเชิงพื้นที่แบบออฟไลน์โดยสมบูรณ์โดยไม่ต้องเรียก Mapbox API พวกมันใช้ Turf.js สำหรับการคำนวณทางภูมิศาสตร์ที่แม่นยำและทำงานได้ทุกที่ แม้ไม่มีอินเทอร์เน็ต

เครื่องมือระยะทาง

คำนวณระยะทางระหว่างพิกัดทางภูมิศาสตร์สองจุดโดยใช้สูตร Haversine

คุณสมบัติ:

  • รองรับหลายหน่วย: กิโลเมตร ไมล์ เมตร ฟุต ไมล์ทะเล
  • การคำนวณระยะทางวงกลมใหญ่ที่แม่นยำ
  • ไม่ต้องเรียก API

ตัวอย่างการใช้งาน: "ระยะทางระหว่างซานฟรานซิสโก (37.7749°N, 122.4194°W) กับนิวยอร์ก (40.7128°N, 74.0060°W) เท่าไร?"

เครื่องมือจุดภายในรูปหลายเหลี่ยม

ทดสอบจุดหนึ่งจุดหรือหลายจุดกับรูปหลายเหลี่ยมหรือรูปหลายเหลี่ยมหลายส่วน โดยส่งคืนเฉพาะจุดที่อยู่ภายใน รองรับจุดเดียวหรือเป็นชุดในการเรียกครั้งเดียว

คุณสมบัติ:

  • ทำงานกับรูปหลายเหลี่ยมที่ซับซ้อนรวมถึงรู
  • รองรับรูปหลายเหลี่ยมหลายส่วน (multipolygons)
  • ทดสอบจุดจำนวนเท่าใดก็ได้ในครั้งเดียว
  • มีประโยชน์สำหรับการกำหนดขอบเขตทางภูมิศาสตร์ (geofencing) การตรวจสอบเขตจัดส่ง และการแบ่งกลุ่มลูกค้า

ตัวอย่างการใช้งาน: "ที่อยู่จัดส่งใดบ้างที่อยู่ในพื้นที่ให้บริการของเรา?"

เครื่องมือจุดปลายทาง

คำนวณจุดปลายทางจากจุดเริ่มต้น ทิศทาง และระยะทาง โดยใช้การออฟเซ็ตแบบ geodesic (วงกลมใหญ่)

คุณสมบัติ:

  • ออฟเซ็ตเป็นเส้นตรง ไม่ใช่เส้นทางที่กำหนดเส้นทาง
  • มีประโยชน์สำหรับ "หาจุดที่อยู่ห่างจาก X ไปทางเหนือ 5 กม." หรือสร้างออฟเซ็ตการค้นหา
  • ไม่ต้องเรียก API

ตัวอย่างการใช้งาน: "จุดที่อยู่ห่างจาก Space Needle ไปทางตะวันออกเฉียงเหนือ 10 กม. คือที่ไหน?"

เครื่องมือทิศทาง

คำนวณทิศทางเข็มทิศ (bearing) จากพิกัดหนึ่งไปยังอีกพิกัดหนึ่ง

คุณสมบัติ:

  • คืนค่าทิศทางเป็นองศา (0-360°)
  • ให้ทิศทางหลัก (N, NE, E, SE, S, SW, W, NW)
  • มีประโยชน์สำหรับการนำทางและการสอบถามทิศทาง

ตัวอย่างการใช้งาน: "ฉันควรไปทางไหนเพื่อไปสนามบินจากที่นี่?"

เครื่องมือจุดกึ่งกลาง

หาจุดกึ่งกลางทางภูมิศาสตร์ระหว่างสองพิกัดตามเส้นทางวงกลมใหญ่

คุณสมบัติ:

  • คำนวณจุดกึ่งกลางที่แท้จริงบนพื้นผิวโค้งของโลก
  • มีประโยชน์สำหรับการแนะนำจุดนัดพบ
  • จัดการการคำนวณระยะทางไกลได้อย่างถูกต้อง

ตัวอย่างการใช้งาน: "จุดกึ่งกลางระหว่างซานฟรานซิสโกและนิวยอร์กคือที่ไหน?"

เครื่องมือเซนทรอยด์

คำนวณศูนย์กลางทางเรขาคณิต (centroid) ของรูปหลายเหลี่ยมหรือรูปหลายเหลี่ยมหลายส่วน

คุณสมบัติ:

  • ทำงานกับรูปทรงที่ซับซ้อน
  • คืนค่าเฉลี่ยเลขคณิตของทุกจุด
  • มีประโยชน์สำหรับการวางป้ายหรือมาร์กเกอร์

ตัวอย่างการใช้งาน: "ฉันควรวางมาร์กเกอร์สำหรับขอบเขตย่านนี้ที่ไหน?"

เครื่องมือพื้นที่

คำนวณพื้นที่ของรูปหลายเหลี่ยม

คุณสมบัติ:

  • รองรับหลายหน่วย: ตารางเมตร ตารางกิโลเมตร เอเคอร์ เฮกตาร์ ตารางไมล์ ตารางฟุต
  • คำนวณพื้นที่บนพื้นผิวโลกได้อย่างแม่นยำ
  • ทำงานกับรูปหลายเหลี่ยมทุกขนาด

ตัวอย่างการใช้งาน: "พื้นที่ของสวนสาธารณะนี้เป็นเอเคอร์เท่าไร?"

เครื่องมือกล่องขอบเขต

คำนวณกล่องขอบเขตขั้นต่ำ (bbox) ที่ครอบคลุมเรขาคณิต

คุณสมบัติ:

  • ทำงานกับจุด เส้น รูปหลายเหลี่ยม และรูปหลายเหลี่ยมหลายส่วน
  • คืนค่า [ลองจิจูดต่ำสุด, ละติจูดต่ำสุด, ลองจิจูดสูงสุด, ละติจูดสูงสุด]
  • มีประโยชน์สำหรับการคำนวณวิวพอร์ตและการจัดทำดัชนีเชิงพื้นที่

ตัวอย่างการใช้งาน: "กล่องขอบเขตสำหรับเส้นทางนี้คืออะไร?"

เครื่องมือบัฟเฟอร์

สร้างโซนบัฟเฟอร์ (รูปหลายเหลี่ยม) รอบจุด เส้น หรือรูปหลายเหลี่ยม

คุณสมบัติ:

  • รองรับหลายหน่วยระยะทาง
  • สร้างบัฟเฟอร์วงกลมรอบจุด
  • มีประโยชน์สำหรับการวิเคราะห์ระยะใกล้และการสร้างโซนอิทธิพล

ตัวอย่างการใช้งาน: "แสดงโซนบัฟเฟอร์ 5 กม. รอบตำแหน่งนี้"

เครื่องมือลดความซับซ้อน

ลดจำนวนจุดยอดในเส้นหรือรูปหลายเหลี่ยมโดยใช้อัลกอริทึม Douglas-Peucker

คุณสมบัติ:

  • ค่าความคลาดเคลื่อนที่ปรับได้สำหรับระดับรายละเอียด
  • คงรูปร่างโดยรวมในขณะที่ลดความซับซ้อน
  • มีประโยชน์สำหรับการลดขนาดไฟล์และปรับปรุงประสิทธิภาพการเรนเดอร์
  • ตัวเลือกในการรักษาโทโพโลยี (ป้องกันการตัดกันเอง)

ตัวอย่างการใช้งาน: "ลดความซับซ้อนของขอบเขตที่ซับซ้อนนี้เพื่อลดจำนวนจุด"

เครื่องมือความยาว

วัดความยาวรวมของเส้นที่กำหนดโดยชุดพิกัด

คุณสมบัติ:

  • รองรับกิโลเมตร ไมล์ เมตร และฟุต
  • มีประโยชน์สำหรับการวัดเส้นทางที่วาด เส้นทาง หรือขอบเขตโดยไม่ต้องเรียก API การกำหนดเส้นทาง

ตัวอย่างการใช้งาน: "เส้นทางเดินป่านี้ยาวเท่าไร?"

เครื่องมือนูน

คำนวณฮัลล์นูนของชุดจุด — รูปหลายเหลี่ยมนูนที่เล็กที่สุดที่ครอบคลุมจุดทั้งหมด

คุณสมบัติ:

  • มีประโยชน์สำหรับการวิเคราะห์พื้นที่ครอบคลุมหรือการประมาณพื้นที่ครอบคลุม
  • ทำงานออฟไลน์โดยไม่ต้องเรียก API

ตัวอย่างการใช้งาน: "รูปหลายเหลี่ยมที่เล็กที่สุดที่ครอบคลุมตำแหน่งร้านค้าทั้งหมดนี้คืออะไร?"

เครื่องมือจุดใกล้สุด

หาจุดที่ใกล้ที่สุดในชุดข้อมูลไปยังจุดเป้าหมายที่กำหนด

คุณสมบัติ:

  • มีประสิทธิภาพมากกว่าการเรียก distance_tool สำหรับแต่ละตัวเลือกแล้วเรียงลำดับ
  • มีประโยชน์สำหรับการหาร้านค้า ป้ายหยุด หรือจุดสังเกตที่ใกล้ที่สุดไปยังตำแหน่ง

ตัวอย่างการใช้งาน: "ร้านค้าใดใกล้ตำแหน่งปัจจุบันของฉันมากที่สุด?"

เครื่องมือจุดใกล้สุดบนเส้น

ยึดจุดไปยังตำแหน่งที่ใกล้ที่สุดบนเส้นหรือเส้นทาง โดยคืนค่าจุดนั้นและระยะทางถึงจุดนั้น

คุณสมบัติ:

  • มีประโยชน์สำหรับ "จุดใดบนเส้นทางนี้ใกล้ตำแหน่งของฉันมากที่สุด?" หรือการจับคู่แผนที่โดยไม่ต้องเรียก API

ตัวอย่างการใช้งาน: "บนเส้นทางเดินป่านี้ ฉันอยู่ใกล้จุดไหนที่สุดในตอนนี้?"

เครื่องมือยูเนียน อินเตอร์เซกต์ และดิฟเฟอเรนซ์

รวมหรือเปรียบเทียบรูปหลายเหลี่ยมสองรูปขึ้นไป — union_tool รวมเข้าด้วยกันเป็นเรขาคณิตเดียว intersect_tool หาพื้นที่ที่ใช้ร่วมกัน และ difference_tool ลบอันหนึ่งออกจากอีกอัน

คุณสมบัติ:

  • มีประโยชน์สำหรับการรวมพื้นที่ให้บริการ การหาความทับซ้อนของความครอบคลุม หรือการคำนวณโซนยกเว้น (เช่น "อะไรที่ครอบคลุมโดยโซน A แต่ไม่ใช่โซน B?")
  • ทำงานออฟไลน์ทั้งหมด — ไม่ต้องเรียก API
  • แต่ละรายการคืนค่าการอ้างอิง render_map_tool เพื่อให้สามารถแสดงผลลัพธ์ได้โดยตรง

ตัวอย่างการใช้งาน: "รวมโซนจัดส่งสองโซนนี้เป็นพื้นที่ครอบคลุมเดียว" / "ไอโซโครนสองอันนี้ทับซ้อนกันตรงไหน?" / "ส่วนใดของพื้นที่ให้บริการนี้ไม่ครอบคลุมโดยไอโซโครน 15 นาทีของเรา?"

เครื่องมือ Mapbox API

เครื่องมือรายการหมวดหมู่ (เลิกใช้งาน)

⚠️ เลิกใช้งาน: ให้ใช้ resource_reader_tool กับ URI mapbox://categories แทน หรือเข้าถึงทรัพยากร mapbox://categories โดยตรงหากไคลเอนต์ของคุณรองรับทรัพยากร MCP

เครื่องมือนี้คงไว้เพื่อความเข้ากันได้ย้อนหลังกับไคลเอนต์ที่ไม่รองรับทรัพยากร MCP หรือ resource_reader_tool

เครื่องมือเมทริกซ์

คำนวณเวลาเดินทางและระยะทางระหว่างหลายจุดโดยใช้ Mapbox Matrix API คุณสมบัติรวมถึง:

  • การคำนวณเส้นทางแบบหนึ่งต่อหลาย หลายต่อหนึ่ง หรือหลายต่อหลายอย่างมีประสิทธิภาพ
  • รองรับโปรไฟล์การเดินทางที่แตกต่างกัน (driving-traffic, driving, walking, cycling)
  • การระบุเวลาเริ่มต้นสำหรับการคำนวณที่คำนึงถึงการจราจร
  • สรุปเส้นทางด้วยเมตริกระยะทางและระยะเวลา
  • ควบคุมการเข้าถึง (ขอบถนน/ไม่จำกัด) และช่วงทิศทางเริ่มต้นที่อนุญาต

เครื่องมือภาพนิ่ง

สร้างภาพแผนที่แบบคงที่โดยใช้ Mapbox static image API คุณสมบัติรวมถึง:

  • สไตล์แผนที่ที่กำหนดเอง (streets, outdoors, satellite, ฯลฯ)
  • ปรับขนาดภาพและระดับซูมได้
  • รองรับมาร์กเกอร์หลายตัวพร้อมสีและป้ายกำกับที่กำหนดเอง
  • ตัวเลือกการซ้อนทับรวมถึงโพลีไลน์และรูปหลายเหลี่ยม
  • ปรับให้พอดีกับพิกัดที่ระบุโดยอัตโนมัติ

เครื่องมือค้นหาหมวดหมู่

ดำเนินการค้นหาหมวดหมู่โดยใช้ Mapbox Search Box category search API คุณสมบัติรวมถึง:

  • ค้นหาจุดสนใจตามหมวดหมู่ (ร้านอาหาร โรงแรม สถานีบริการน้ำมัน ฯลฯ)
  • กรองตามความใกล้ทางภูมิศาสตร์
  • ปรับขีดจำกัดผลลัพธ์ได้
  • ข้อมูลเมตาที่สมบูรณ์สำหรับแต่ละผลลัพธ์
  • รองรับหลายภาษา

เครื่องมือจีโอโค้ดย้อนกลับ

ดำเนินการจีโอโค้ดย้อนกลับโดยใช้ Mapbox geocoding V6 API คุณสมบัติรวมถึง:

  • แปลงพิกัดทางภูมิศาสตร์เป็นที่อยู่ที่อ่านได้
  • ปรับระดับรายละเอียดได้ (ถนน ย่าน เมือง ฯลฯ)
  • กรองผลลัพธ์ตามประเภท (ที่อยู่ จุดสนใจ ย่าน ฯลฯ)
  • รองรับหลายภาษา
  • ข้อมูลบริบทตำแหน่งที่สมบูรณ์

เครื่องมือตำแหน่งภาคพื้นดิน

ตอบคำถาม "มีอะไรใกล้พิกัดนี้" ในการเรียกครั้งเดียว — ชื่อสถานที่ จุดสนใจใกล้เคียง และการเข้าถึงตามเวลาเดินทาง — จากข้อมูล Mapbox สดพร้อมการอ้างอิง ใช้สิ่งนี้แทนการต่อ reverse_geocode_tool กับการค้นหาเว็บ

คุณสมบัติ:

  • จำแนกคำถาม (การกำหนดเส้นทาง บริบทย่าน การค้นหาจุดสนใจ หรือภูมิภาค/การเข้าถึง) และดึงข้อมูลที่เกี่ยวข้องเท่านั้น
  • ค้นหาจุดสนใจใกล้เคียงตามหมวดหมู่ เมื่อมีการร้องขอ
  • สรุปการเข้าถึงตามเวลาเดินทาง (อิงจากไอโซโครน)
  • คืนค่าการอ้างอิง render_map_tool พร้อมตำแหน่งที่อ้างอิงและจุดสนใจใกล้เคียงที่วาดไว้

ตัวอย่างการใช้งาน: "พิกัดนี้อยู่ในย่านใด และมีร้านกาแฟใกล้เคียงหรือไม่?"

เครื่องมือรายละเอียดสถานที่

ดึงข้อมูลโดยละเอียดเกี่ยวกับสถานที่เฉพาะโดยใช้ Mapbox ID — รูปภาพ เวลาเปิดทำการ คะแนน หมายเลขโทรศัพท์ และ URL เว็บไซต์ ใช้หลัง search_and_geocode_tool, category_search_tool หรือ reverse_geocode_tool เพื่อรับรายละเอียดเพิ่มเติมเกี่ยวกับผลลัพธ์เฉพาะ

ตัวอย่างการใช้งาน: "บอกฉันเพิ่มเติมเกี่ยวกับผลลัพธ์ร้านกาแฟแรกนั้น — เวลาเปิดทำการ หมายเลขโทรศัพท์ และเว็บไซต์"

เครื่องมือเส้นทาง

ดึงเส้นทางการเดินทางโดยใช้ Mapbox Directions API คุณสมบัติรวมถึง:

  • รองรับโปรไฟล์การเดินทางที่แตกต่างกัน: การขับขี่ (พร้อมการจราจรสดหรือทั่วไป) การเดิน และการปั่นจักรยาน
  • เส้นทางจากหลายจุดแวะพัก (2-25 คู่พิกัด)
  • ตัวเลือกเส้นทางทางเลือก
  • คำอธิบายประกอบเส้นทาง (ระยะทาง ระยะเวลา ความเร็ว ความแออัด)
  • ตัวเลือกการจัดตารางเวลา:
    • เวลาออกเดินทางในอนาคต (depart_at) สำหรับโปรไฟล์การขับขี่และการขับขี่พร้อมการจราจร
    • เวลาที่ต้องการถึง (arrive_by) สำหรับโปรไฟล์การขับขี่เท่านั้น
  • การปรับให้เหมาะสมตามโปรไฟล์:
    • การขับขี่: ข้อจำกัดขนาดยานพาหนะ (ความสูง ความกว้าง น้ำหนัก)
  • ตัวเลือกการยกเว้นสำหรับการกำหนดเส้นทาง:
    • การยกเว้นทั่วไป: เส้นทางเรือข้ามฟาก ทางด่วนเก็บเงินสดเท่านั้น
    • การยกเว้นเฉพาะการขับขี่: ทางด่วน ทางหลวงพิเศษ ถนนไม่ลาดยาง อุโมงค์ พรมแดนประเทศ พรมแดนรัฐ
    • การยกเว้นจุดที่กำหนดเอง (สูงสุด 50 จุดทางภูมิศาสตร์ที่ต้องหลีกเลี่ยง)
  • รูปแบบเอาต์พุตเรขาคณิต GeoJSON

เครื่องมือไอโซโครน

คำนวณพื้นที่ที่สามารถเข้าถึงได้ภายในเวลาที่กำหนดจากตำแหน่งโดยใช้ Mapbox Isochrone API คุณสมบัติรวมถึง:

  • รองรับโปรไฟล์การเดินทางที่แตกต่างกัน (การขับขี่ การเดิน การปั่นจักรยาน)
  • ปรับเวลาเดินทางหรือระยะทางได้
  • การสร้างเส้นชั้นความสูงหลายเส้น (เช่น ช่วง 15, 30, 45 นาที)
  • ระบุเวลาออกเดินทางหรือเวลาถึงได้
  • ปรับแต่งสีสำหรับการแสดงผล

เครื่องมือค้นหาและจีโอโค้ด

ใช้ Mapbox Search Box Text Search API เพื่อค้นหาและจีโอโค้ดจุดสนใจ ที่อยู่ สถานที่ และประเภทอื่นๆ ที่ API นั้นรองรับ เครื่องมือนี้รวมฟังก์ชันที่ก่อนหน้านี้มีใน ForwardGeocodeTool และ PoiSearchTool (จากเวอร์ชันก่อนหน้าของ MCP เซิร์ฟเวอร์นี้) เป็นเครื่องมือเดียว

เครื่องมือจับคู่แผนที่

ยึดร่องรอย GPS กับเครือข่ายถนนโดยใช้ Mapbox Map Matching API คุณสมบัติรวมถึง:

  • แปลงร่องรอย GPS ที่มีสัญญาณรบกวนเป็นเส้นทางที่สะอาดบนเครือข่ายถนน
  • รองรับโปรไฟล์การเดินทางที่แตกต่างกัน (การขับขี่ การขับขี่พร้อมการจราจร การเดิน การปั่นจักรยาน)
  • จัดการคู่พิกัดได้สูงสุด 100 คู่ต่อคำขอ
  • ระบุเวลาเพื่อความแม่นยำที่ดีขึ้นตามความเร็ว
  • ปรับรัศมีการยึดได้สำหรับระดับคุณภาพ GPS ที่แตกต่างกัน
  • คำอธิบายประกอบเส้นทาง (ขีดจำกัดความเร็ว ระยะทาง ระยะเวลา ความแออัดการจราจร)
  • รูปแบบเอาต์พุตเรขาคณิตหลายแบบ (GeoJSON, polyline)

ตัวอย่างการใช้งาน: "ทำความสะอาดร่องรอย GPS นี้และยึดกับถนน: [พิกัดพร้อมเวลา]"

เครื่องมือการปรับให้เหมาะสม

ค้นหาเส้นทางที่เหมาะสมที่สุดผ่านหลายตำแหน่งโดยใช้ Mapbox Optimization API คุณสมบัติรวมถึง:

  • แก้ปัญหาพนักงานขายเดินทาง (TSP) สำหรับ 2-12 ตำแหน่ง
  • รองรับโปรไฟล์การเดินทางที่แตกต่างกัน (การขับขี่ การขับขี่พร้อมการจราจร การเดิน การปั่นจักรยาน)
  • กำหนดจุดเริ่มต้นและจุดสิ้นสุดได้อย่างยืดหยุ่น
  • การปรับให้เหมาะสมแบบไปกลับหรือเที่ยวเดียว
  • คำแนะนำการนำทางแบบเลี้ยวต่อเลี้ยว (ไม่บังคับ)
  • คำอธิบายประกอบเส้นทาง (ระยะทาง ระยะเวลา ความเร็ว)
  • รูปแบบเอาต์พุตเรขาคณิตหลายแบบ (GeoJSON, polyline)

ตัวอย่างการใช้งาน: "ค้นหาเส้นทางที่เหมาะสมที่สุดเพื่อเยี่ยมชม 5 จุดนี้: [รายการที่อยู่หรือพิกัด]"

หมายเหตุ: API V2 ที่มีคุณสมบัติขั้นสูง (กรอบเวลา ข้อจำกัดความจุ ยานพาหนะหลายคัน) มีให้ใช้งานแต่ต้องเข้าถึงแบบเบต้า การใช้งาน V2 รวมอยู่ในโค้ดเบสแต่ไม่ได้ลงทะเบียนโดยค่าเริ่มต้น

การพัฒนา

การตรวจสอบเซิร์ฟเวอร์

โดยใช้ Node.js

# Run the built image
npm run inspect:build

โดยใช้ Docker

# Build the Docker image
docker build -t mapbox-mcp-server .

# Run and inspect the server
npx @modelcontextprotocol/inspector docker run -i --rm --env MAPBOX_ACCESS_TOKEN="YOUR_TOKEN" mapbox-mcp-server

สร้างเครื่องมือใหม่

npx plop create-tool
# provide tool name without suffix (e.g. Search)

การเผยแพร่เวอร์ชันใหม่

# 1. Bump version in package.json
npm version <new-version> --no-git-tag-version

# 2. Sync version to manifest.json and server.json
npm run sync-manifest

# 3. Prepare CHANGELOG (replaces "Unreleased" with version and date)
npm run changelog:prepare-release <new-version>

# 4. Update package-lock.json
npm install

# 5. Review changes, then commit and tag
git add package.json package-lock.json manifest.json server.json CHANGELOG.md
git commit -m "Release v<new-version>"
git tag v<new-version>
git push && git push --tags

สำคัญ: เวิร์กโฟลว์ผู้เผยแพร่ตรวจสอบว่าเวอร์ชัน package.json และ server.json ตรงกับเวอร์ชันที่เผยแพร่ การข้ามการเพิ่มเวอร์ชันหรือการซิงค์ manifest จะทำให้การเผยแพร่ล้มเหลว

การติดตาม OpenTelemetry

MCP เซิร์ฟเวอร์นี้รวมการติดตาม OpenTelemetry ที่ครอบคลุมสำหรับการสังเกตการณ์ในสภาพแวดล้อมการผลิต:

การสาธิตอย่างรวดเร็ว

# 1. Copy the example configuration
cp .env.example .env

# 2. Edit .env to add your MAPBOX_ACCESS_TOKEN and configure tracing

# 3. Start Jaeger for local development
npm run tracing:jaeger:start

# 4. Run the server (it will automatically use .env configuration)
npm run inspect:build

# 5. View traces at http://localhost:16686

# 6. Stop Jaeger when done
npm run tracing:jaeger:stop

หมายเหตุ: เซิร์ฟเวอร์จะโหลดการกำหนดค่าจากไฟล์ .env ของคุณโดยอัตโนมัติเมื่อเริ่มต้น ไฟล์ .env.example มีตัวอย่างการกำหนดค่าสำหรับแพลตฟอร์มการสังเกตการณ์หลายรายการ

แพลตฟอร์มการสังเกตการณ์ที่รองรับ

ตัวอย่างการกำหนดค่าที่รวมอยู่ใน .env.example สำหรับ:

ผู้ให้บริการคลาวด์:

  • ☁️ AWS X-Ray
  • ☁️ Azure Monitor (Application Insights)
  • ☁️ Google Cloud Trace

แพลตฟอร์ม SaaS:

  • 📊 Datadog
  • 📊 New Relic
  • 📊 Honeycomb
  • 📊 แบ็กเอนด์ที่รองรับ OTLP ใด ๆ

การกำหนดค่าสำหรับการใช้งานจริง

ดู docs/tracing.md สำหรับคำแนะนำการตั้งค่าที่สมบูรณ์ รวมถึง:

  • 🔧 คำแนะนำการกำหนดค่าเฉพาะแพลตฟอร์ม
  • 📊 การตั้งค่าการรับรองความถูกต้องและปลายทาง
  • 🎯 แอตทริบิวต์และบริบทการติดตามแบบกำหนดเอง
  • 🚀 การปรับประสิทธิภาพให้เหมาะสม (โอเวอร์เฮดน้อยที่สุด)
  • 🔍 การแก้ไขปัญหาและการดีบัก

คุณสมบัติการติดตาม:

  • ✅ การติดตามการโหลดการกำหนดค่า (การโหลดไฟล์ .env)
  • ✅ การติดตามการทำงานของเครื่องมืออัตโนมัติ
  • ✅ การตรวจวัดคำขอ HTTP ด้วย ID การเชื่อมโยง CloudFront
  • ✅ ตัวส่งออกที่กำหนดค่าได้ (คอนโซล, OTLP)
  • ✅ คำนึงถึงความปลอดภัย (การปกป้องข้อมูล, การตรวจสอบ JWT)
  • ✅ พร้อมสำหรับการใช้งานจริง (โอเวอร์เฮด CPU น้อยกว่า 1%)

การมีส่วนร่วม

เรายินดีต้อนรับการมีส่วนร่วมกับ Mapbox MCP Server! โปรดอ่าน CONTRIBUTING.md ก่อนส่ง pull request

มาตรฐานและแนวทางฉบับเต็ม:

เริ่มต้นอย่างรวดเร็วสำหรับผู้มีส่วนร่วม

  1. Fork พื้นที่เก็บข้อมูลและ clone fork ของคุณ
  2. ติดตั้ง dependencies: npm install
  3. ทำการเปลี่ยนแปลงตามมาตรฐานการเขียนโค้ดของเรา
  4. รันการทดสอบและ linting: npm test && npm run lint
  5. เพิ่มการทดสอบสำหรับฟังก์ชันการทำงานใหม่ใด ๆ
  6. ส่ง pull request พร้อมคำอธิบายที่ชัดเจน

การมีส่วนร่วมทั้งหมดต้องผ่านการตรวจสอบ CI และกระบวนการตรวจสอบโค้ดของเรา ดู docs/engineering_standards.md สำหรับข้อกำหนดโดยละเอียด

การใช้ข้อมูลและความเป็นส่วนตัว

ข้อมูลใดที่ถูกส่งไปยัง Mapbox APIs

เมื่อคุณใช้เครื่องมือของ MCP server ข้อมูลต่อไปนี้จะถูกส่งโดยตรงจากสภาพแวดล้อมของคุณไปยัง Mapbox APIs:

  • เครื่องมือ Geocoding: ข้อความที่อยู่/ตำแหน่ง พิกัด ตัวกรองประเทศ/ภูมิภาค
  • เครื่องมือค้นหา: คำค้นหา พิกัดตำแหน่งสำหรับความใกล้เคียง ตัวกรองหมวดหมู่
  • เครื่องมือเส้นทาง: พิกัดเริ่มต้น/สิ้นสุด จุดผ่านเส้นทาง การตั้งค่าเส้นทาง ข้อจำกัดของยานพาหนะ
  • เครื่องมือ Matrix: คู่พิกัดหลายคู่ โปรไฟล์การเดินทาง เวลาออกเดินทาง
  • เครื่องมือแผนที่แบบคงที่: พิกัด ระดับซูม การตั้งค่าสไตล์ ข้อมูลเครื่องหมาย
  • เครื่องมือ Isochrone: พิกัดต้นทาง พารามิเตอร์เวลา/ระยะทาง โปรไฟล์การเดินทาง

ความเป็นส่วนตัวของคุณ

  • การทำงานในเครื่อง: การเรียก API ทั้งหมดทำโดยตรงจากสภาพแวดล้อมของคุณไปยัง Mapbox APIs
  • ความปลอดภัยของโทเค็น: โทเค็น API ของ Mapbox ของคุณยังคงอยู่บนเครื่องของคุณและไม่ถูกส่งหรือจัดเก็บโดย MCP server นี้
  • ไม่มีการจัดเก็บข้อมูล: MCP server นี้ไม่จัดเก็บ บันทึก หรือรวบรวมข้อมูลหรือคำขอ API ของคุณ
  • การสื่อสารโดยตรง: ไม่มีเซิร์ฟเวอร์ตัวกลางระหว่างคุณกับ Mapbox APIs

การใช้ข้อมูลของบุคคลที่สาม

  • นโยบายความเป็นส่วนตัวของ Mapbox ควบคุมข้อมูลที่ส่งไปยัง API ของพวกเขา: https://www.mapbox.com/legal/privacy/
  • การใช้งาน API: ข้อกำหนด API มาตรฐานของ Mapbox ใช้กับคำขอทั้งหมดที่ทำผ่านเครื่องมือเหล่านี้
  • การเก็บรักษาข้อมูล: อ้างอิงเอกสารประกอบของ Mapbox สำหรับนโยบายการเก็บรักษาข้อมูลของพวกเขา

การสนับสนุนและการติดต่อ

สำหรับปัญหาของ MCP Server

สำหรับคำถามเกี่ยวกับ Mapbox API

ความมุ่งมั่นในการบำรุงรักษา

MCP server นี้ได้รับการดูแลอย่างเป็นทางการโดย Mapbox, Inc. เรามอบ:

  • อัปเดตเป็นประจำสำหรับคุณสมบัติใหม่ของ Mapbox API
  • การแก้ไขข้อบกพร่องและการอัปเดตความปลอดภัย
  • ความเข้ากันได้กับโปรโตคอล MCP เวอร์ชันล่าสุด
  • การสนับสนุนชุมชนผ่าน GitHub issues

สัญญาอนุญาต MIT