mcpField
C
cesium-mcp-dev

cesium-mcp-dev

本地服务
github.com/gaopengbin开发工具1476 天前更新

关于 cesium-mcp-dev

cesium-mcp-dev 是面向使用 CesiumJS 的 AI 编码助手的 MCP 服务。它通过三个专用工具提供 API 文档查询、代码片段生成和 Entity 配置构建。

主要功能

  1. 01查询 Cesium API 参考
  2. 02根据描述生成 Cesium 代码
  3. 03按类型构建 Entity 配置
  4. 04返回用法示例和签名

适用场景

  1. 01编码时查询 Cesium 类或方法
  2. 02根据任务描述生成 CesiumJS 代码片段
  3. 03构建带样式的 Entity 定义

MCP 相关

通过 MCP 提供三个 Cesium 开发工具:API 查询、代码生成和 Entity 配置构建。IDE AI 助手通过 stdio 连接服务。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"gaopengbin-cesium-mcp-dev": {
"command": "npx",
"args": [
"-y",
"cesium-mcp-dev"
]
}
}
}
启动命令npx -y cesium-mcp-dev

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmcesium-mcp-dev1.139.2

工具

3

收录的工具列表 · 更新于 2 周前

参数类型必填说明
querystring是Cesium 类名或关键词,如 "Viewer"、"Entity"、"Color"、"flyTo"
categoryenum否查询类别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 构建工具。

npm version license

这是什么?

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-devCesium
1.145.x~1.145.0

许可证

MIT

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。