/ الدليل / الملعب / Cesium MCP
← كل الخوادم ↗ GitHub
● مجتمع gaopengbin 🔑 يتطلب مفتاحك

Cesium MCP

بواسطة gaopengbin · gaopengbin/cesium-mcp

التحكم باللغة الطبيعية في كرة CesiumJS ثلاثية الأبعاد - قم بالتحليق بالكاميرا، وإسقاط الكيانات، وتبديل الطبقات، وتحميل مربعات ثلاثية الأبعاد، وتحريك المسارات.

يتيح cesium-mcp لعميل MCP قيادة عارض CesiumJS موجود. 58 أداة عبر 12 مجموعة أدوات تغطي التنقل بين الكاميرا/العرض، والكيانات (العلامات، والتسميات، والنماذج، والمضلعات، والخطوط المتعددة)، والطبقات (GeoJSON، وخرائط الأساس)، والتفاعل (لقطات الشاشة، والإبراز، والقياس)، والميزات المتقدمة (البلاط ثلاثي الأبعاد، والتضاريس، والرسوم المتحركة، والمسارات، والخرائط الحرارية، وتحديد الموقع الجغرافي). يتم تنشيط الأدوات الأساسية 31 بشكل افتراضي؛ قم بتعيين CESIUM_TOOLSETS=all للمجموعة الكاملة. قم بإقرانه مع أي تطبيق يتضمن CesiumJS للحصول على تصور جغرافي مكاني يعتمد على الذكاء الاصطناعي.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

cesium-mcp.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "cesium-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cesium-mcp-runtime"
      ],
      "env": {
        "CESIUM_TOOLSETS": "all"
      }
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "cesium-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cesium-mcp-runtime"
      ],
      "env": {
        "CESIUM_TOOLSETS": "all"
      }
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "cesium-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cesium-mcp-runtime"
      ],
      "env": {
        "CESIUM_TOOLSETS": "all"
      }
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "cesium-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cesium-mcp-runtime"
      ],
      "env": {
        "CESIUM_TOOLSETS": "all"
      }
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "cesium-mcp",
      "command": "npx",
      "args": [
        "-y",
        "cesium-mcp-runtime"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "cesium-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "cesium-mcp-runtime"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add cesium-mcp -- npx -y cesium-mcp-runtime

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: Cesium MCP

يطير إحاطة الموقع على الكرة الأرضية الحية

👤 فرق العمليات والخدمات اللوجستية والتخطيط ⏱ ~15 min intermediate

متى تستخدمه: تريد ملخصًا مباشرًا ثلاثي الأبعاد بدلاً من الشرائح الثابتة.

المتطلبات الأساسية
  • تطبيق عارض CesiumJS قيد التشغيل — تضمين السيزيوم في تطبيقك؛ فضح الموصل
  • رمز الوصول إلى Cesium Ion (في حالة استخدام أصول Ion) — https://ion.cesium.com/tokens
الخطوات
  1. يطير إلى الموقع
    سافر إلى برج إيفل وأسقط علامة حمراء تحمل علامة "الموقع أ".✓ تم النسخ
    → الرسوم المتحركة بالكاميرا؛ تظهر العلامة مع التسمية
  2. تراكب البيانات
    قم بتحميل GeoJSON لحدود الأحياء كطبقة شفافة.✓ تم النسخ
    → طبقة مرئية وتفاعلية
  3. يأسر
    التقط لقطة شاشة يمكنني لصقها في الشريحة.✓ تم النسخ
    → عادت PNG

النتيجة: عرض موجز مباشر وقابل للربط بدلاً من الصورة المجمدة.

المزالق
  • تحميل GeoJSON ضخم بدون تبسيط — التبسيط إلى أعداد رؤوس معقولة؛ يمكن أن يختنق السيزيوم بمضلعات ذات مليون قمة
اجمعها مع: filesystem

تحريك مسار الأسطول مع مرور الوقت

👤 فرق العمليات والتنقل ⏱ ~25 min intermediate

متى تستخدمه: لديك مواقع ذات طابع زمني وتريد التشغيل على الكرة الأرضية.

المتطلبات الأساسية
  • بيانات الموقع المرمزة بالوقت — CSV أو GeoJSON مع الطوابع الزمنية
الخطوات
  1. تحميل الكيانات مع الوقت
    قم بإضافة 3 كيانات للمركبات مع مسارات SampledPositionProperty الخاصة بها من flesh.csv.✓ تم النسخ
    → تقدم الكيانات؛ الجدول الزمني يظهر المدى
  2. يلعب
    حرك الصورة بمعدل 10x، وتتبع الكاميرا السيارة A.✓ تم النسخ
    → التشغيل السلس. الكاميرا مقفلة على الموضوع

النتيجة: تشغيل الأسطول التفاعلي بدون كتابة كود السيزيوم.

قم بتحميل مجموعة بيانات 3D Tiles وافحص مبنى واحدًا

👤 التخطيط الحضري، AEC، فرق BIM ⏱ ~20 min advanced

متى تستخدمه: لديك مجموعة بلاطات ثلاثية الأبعاد وتريد الاستعلام عن إحدى الميزات.

الخطوات
  1. قم بتحميل مجموعة البلاط
    قم بتحميل بلاطات ثلاثية الأبعاد على <URL>، وقم بتوجيه التضاريس، وقم بتعيين الحد الأقصى لخطأ مساحة الشاشة 16.✓ تم النسخ
    → يتم عرض مجموعة البلاط بدون قتال عميق
  2. تسليط الضوء + القياس
    قم بتمييز المبنى في الكيان المختار؛ قياس ارتفاعه.✓ تم النسخ
    → أبرز المبنى؛ تم الإبلاغ عن الارتفاع

النتيجة: فحص تفاعلي سريع لمراجعة أصحاب المصلحة.

المزالق
  • قص الكاميرا عبر التضاريس — تمكين اختبار العمق مقابل التضاريس؛ لحن مقطع قريب / بعيد

تراكب خريطة حرارية لبيانات النقطة

👤 المحللون يتصورون الكثافة ⏱ ~15 min intermediate

متى تستخدمه: أنت بحاجة إلى خريطة حرارية على الخريطة بدون أداة تخطيط خارجية.

الخطوات
  1. استيعاب النقاط
    نقاط الاستيراد.csv (خط الطول، خطوط العرض، الوزن).✓ تم النسخ
    → النقاط المحملة في مجموعة أدوات الخريطة الحرارية
  2. لحن المظهر
    نصف قطر الخريطة الحرارية 25 بكسل، لون متدرج.✓ تم النسخ
    → تراكب منمق مرئي

النتيجة: خريطة حرارية يمكن الدفاع عنها مدمجة في الكرة الأرضية الخاصة بك.

اجمعها مع: mcp-echarts

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

cesium-mcp + filesystem

قم بتحميل مجموعات البيانات المحلية (GeoJSON، وCSV) وعرضها على الكرة الأرضية

افتح ./data/points.csv، وقم باستيراده كخريطة حرارية على الكرة الأرضية.✓ تم النسخ
cesium-mcp + mcp-echarts

قم بإقران الكرة الأرضية ثلاثية الأبعاد بالمخططات الإحصائية الكلاسيكية

خريطة كثافة السيزيوم + مخططات بيانية على الجانب - مرشحات متزامنة.✓ تم النسخ
cesium-mcp + fetch

سحب البث المباشر (AIS، ADS-B) وتحريكه

جلب مواقع السفن الحية وتحديث الكيانات كل 30 ثانية.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
camera.flyTo / lookAt / saveView / loadView coords / heading / pitch / roll الملاحة بالكاميرا 0
entities.add / update / remove geometry + styling علامات، تسميات، نماذج، مضلعات، خطوط متعددة 0
layers.add (GeoJSON / imagery) / toggle source + style تبديل أو إضافة الطبقات الجغرافية المكانية bandwidth for remote sources
tiles3d.load / query tileset URL عرض البلاط ثلاثي الأبعاد واختيار الميزات 0
terrain.set terrain provider مبادلة مقدمي التضاريس 0
animation.play / trajectory.load time interval / track التشغيل على أساس الوقت 0
interaction.screenshot / highlight / measure area or picked entity التقاط واختيار وقياس 0
heatmap.add points + radius + gradient تصور الكثافة 0
geolocation.goto name or coords التنقل بالمكان المسمى 0

التكلفة والحدود

تكلفة التشغيل

حصة API
لا شيء للخادم نفسه؛ الرموز المميزة لـ Cesium Ion لها حصتها الخاصة إذا كنت تستخدم أصول Ion
الرموز لكل استدعاء
العمليات الصغيرة؛ وحدات البايت / الصور ثلاثية الأبعاد غير موجودة في عدد الرموز المميزة
التكلفة المالية
مجاني - السيزيوم مفتوح المصدر
نصيحة
التزم بالأدوات الأساسية الافتراضية البالغ عددها 31 أداة إلا إذا كنت بحاجة إلى المجموعة الموسعة على وجه التحديد؛ سطح أبسط = عدد أقل من المنعطفات الخاطئة.

الأمان

الصلاحيات والأسرار ونطاق الأثر

تخزين بيانات الاعتماد: رمز السيزيوم أيون في env var إذا تم استخدامه.
نقل البيانات الخارجي: جلب إلى موفري الصور/التضاريس الذين قمت بتكوينهم (Ion، MapBox، خوادم البلاط المخصصة).

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

تقفز الكاميرا إلى الفضاء بدلًا من الهدف

تحقق من ترتيب خطوط العرض/خطوط الطول (يستخدم السيزيوم خطوط الطول وخطوط العرض) وقيم الارتفاع.

تحقق: Log args passed to camera.flyTo
تبدو GeoJSON مسطحة

أخذ عينات التضاريس معطل؛ تمكين clamToGround في خيارات الطبقة.

تحقق: Inspect the layer's styling options
مجموعة البلاط سوداء / مفقودة

يحظر CORS العديد من مجموعات البلاط؛ المضيف أو الوكيل مع الرؤوس المناسبة.

تحقق: DevTools Network panel for the tileset URL

البدائل

Cesium MCP مقابل البدائل

البديلمتى تستخدمهاالمقايضة
google-mapsتعد الخرائط ثنائية الأبعاد وواجهة برمجة تطبيقات الأماكن كافيةلا توجد كرة أرضية ثلاثية الأبعاد أو بلاط ثلاثي الأبعاد
google-mapأنت بالفعل على خرائط Google بالأشعة تحت الحمراءأقل ثراءً ثلاثي الأبعاد من السيزيوم
mcp-echartsبياناتك إحصائية وليست جغرافية مكانيةلا يوجد سياق الخريطة

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills