关于 cesium-mcp-dev
cesium-mcp-dev 是面向使用 CesiumJS 的 AI 编码助手的 MCP 服务。它通过三个专用工具提供 API 文档查询、代码片段生成和 Entity 配置构建。
主要功能
- 01查询 Cesium API 参考
- 02根据描述生成 Cesium 代码
- 03按类型构建 Entity 配置
- 04返回用法示例和签名
适用场景
- 01编码时查询 Cesium 类或方法
- 02根据任务描述生成 CesiumJS 代码片段
- 03构建带样式的 Entity 定义
MCP 相关
通过 MCP 提供三个 Cesium 开发工具:API 查询、代码生成和 Entity 配置构建。IDE AI 助手通过 stdio 连接服务。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
3收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| query | string | 是 | Cesium 类名或关键词,如 "Viewer"、"Entity"、"Color"、"flyTo" |
| category | enum | 否 | 查询类别class | method | property | all |
详细介绍
cesium-mcp-dev
默认启用使用情况统计,并会在启动时向 stderr 输出通知。设置 CESIUM_TELEMETRY_DISABLED=1、DO_NOT_TRACK=1,或传入 --no-telemetry,即可禁用统计。收集的字段和隐私说明。
English | 中文
面向 IDE AI 助手的 MCP 服务——提供 Cesium API 文档、代码生成和 Entity 构建工具。
这是什么?
cesium-mcp-dev 通过提供 API 文档查询、代码片段生成和 Entity 配置构建,帮助 AI 编码助手(GitHub Copilot、Cursor、Claude Code 等)编写更好的 CesiumJS 代码,以上功能均通过 MCP 协议提供。
稳定版 stdio 服务使用 MCP SDK v2,并可与 MCP 2025-11-25
和 2026-07-28 客户端协商。
IDE AI Assistant <--MCP stdio--> cesium-mcp-dev --> API docs, code snippets, Entity configs
安装和运行
npx -y cesium-mcp-dev
IDE 配置
VS Code(Copilot)
在 .vscode/mcp.json 中:
{
"servers": {
"cesium-dev": {
"command": "npx",
"args": ["cesium-mcp-dev"]
}
}
}
Cursor
在 .cursor/mcp.json 中:
{
"mcpServers": {
"cesium-dev": {
"command": "npx",
"args": ["cesium-mcp-dev"]
}
}
}
Claude Desktop
{
"mcpServers": {
"cesium-dev": {
"command": "npx",
"args": ["cesium-mcp-dev"]
}
}
}
MCP 工具(3 个)
cesium_api_lookup
按类名、方法或属性查询 Cesium API 文档。
Input: "Viewer"
Output: Constructor signature, properties, methods, and usage examples
覆盖的类:Viewer、Entity、Camera、Cartesian3、Color、GeoJsonDataSource、ImageryLayer、Cesium3DTileset、Material、ScreenSpaceEventHandler、flyTo、setView(12 个类)
cesium_code_gen
根据自然语言描述生成 Cesium 代码。
Input: "Add a red point marker at Tiananmen Square"
Output: Complete TypeScript code snippet ready to use
内置代码片段:飞往指定位置、添加标记、加载 GeoJSON、绘制折线、绘制多边形、加载 3D Tiles、切换底图、点击处理程序、截图、热力图、轨迹动画(11 种场景)
cesium_entity_builder
通过指定类型和属性,以交互方式构建 Entity 配置。
Input: type: "polygon", position: {lon: 116.4, lat: 39.9}, color: "#ff6600"
Output: Complete Entity definition with material, style, and ground clamping
支持的类型:point、billboard、label、polyline、polygon、model、ellipse、box(8 种类型)
交互示例
AI 助手询问:“如何从 Cesium Ion 加载 3D Tiles 模型?”
助手使用 "Cesium3DTileset" 调用 cesium_api_lookup 获取 API 参考,然后根据用户的具体需求调用 cesium_code_gen,生成可直接使用的代码。
AI 助手询问:“创建一个半透明蓝色多边形的 Entity。”
助手通过 type: "polygon", color: "#0066ff", opacity: 0.5 调用 cesium_entity_builder,并获取完整的代码输出。
兼容性
| cesium-mcp-dev | Cesium |
|---|---|
| 1.145.x | ~1.145.0 |
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。