作者 gaopengbin · gaopengbin/cesium-mcp
CesiumJS 3D地球仪的自然语言控制—飞行摄像头、放置实体、切换图层、加载3D图块、动画轨迹。
cesium-mcp允许MCP客户端驱动现有的CesiumJS查看器。12个工具集的58个工具涵盖相机/视图导航、实体（标记、标签、模型、多边形、折线）、图层（ GeoJSON、底图）、交互（屏幕截图、高亮显示、测量）和高级功能（ 3D图块、地形、动画、轨迹、热图、地理位置）。核心31工具默认激活；为整个套件设置“CESIUM_toolsets = all”。 将其与嵌入CesiumJS的任何应用程序配对，以获得人工智能驱动的地理空间可视化。
%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。保存后重启应用。
{
"mcpServers": {
"cesium-mcp": {
"command": "npx",
"args": [
"-y",
"cesium-mcp-runtime"
],
"env": {
"CESIUM_TOOLSETS": "all"
}
}
}
}Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。
{
"mcpServers": {
"cesium-mcp": {
"command": "npx",
"args": [
"-y",
"cesium-mcp-runtime"
],
"env": {
"CESIUM_TOOLSETS": "all"
}
}
}
}点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。
{
"mcpServers": {
"cesium-mcp": {
"command": "npx",
"args": [
"-y",
"cesium-mcp-runtime"
],
"env": {
"CESIUM_TOOLSETS": "all"
}
}
}
}格式与 Claude Desktop 相同。重启 Windsurf 生效。
{
"mcpServers": [
{
"name": "cesium-mcp",
"command": "npx",
"args": [
"-y",
"cesium-mcp-runtime"
]
}
]
}Continue 使用服务器对象数组，而非映射。
{
"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 卸载。
何时使用： 您需要的是实时3D简报，而不是静态幻灯片。
结果： 实时、可链接的简报视图，而不是冻结的图像。
何时使用： 您有带时间戳的位置，并希望在全球范围内播放。
结果： 无需编写Cesium代码即可进行交互式车队播放。
何时使用： 您有一个3D图块图块集，并希望查询地图项。
结果： 用于利益相关者审核的快速交互式检查。
何时使用： 您需要地图上的热图，而无需外部绘图工具。
结果： 内置于地球仪中的可防御热图。
| 工具 | 输入参数 | 何时调用 | 成本 |
|---|---|---|---|
| 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 | 3D瓷砖渲染和特征拾取 | 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 |
摄像头跳转到空间而不是目标检查纬度/经度顺序（铯使用经度，纬度）和海拔值。
Log args passed to camera.flyToGeoJSON看起来很平地形采样已关闭；在图层选项中启用clampToGround。
Inspect the layer's styling options瓷砖组黑色/缺失CORS会阻止许多磁贴组；具有正确标头的主机或代理。
DevTools Network panel for the tileset URL| 替代方案 | 何时用它替代 | 权衡 |
|---|---|---|
| google-maps | 2D地图和位置API就足够了 | 没有3D地球仪或3D瓷砖 |
| google-map | 您已使用Google地图infra | 富含3D的含量低于铯 |
| mcp-echarts | 您的数据是统计数据，而不是地理空间数据 | 无地图上下文 |