cesium-mcp-dev 1.139.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 GeoAgent Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,120 @@
+# cesium-mcp-dev
+
+> MCP Server for IDE AI assistants -- Cesium API documentation, code generation, and Entity builder.
+
+[![npm version](https://img.shields.io/npm/v/cesium-mcp-dev.svg)](https://www.npmjs.com/package/cesium-mcp-dev)
+[![license](https://img.shields.io/npm/l/cesium-mcp-dev.svg)](LICENSE)
+
+## What is this?
+
+`cesium-mcp-dev` helps AI coding assistants (GitHub Copilot, Cursor, Claude Code, etc.) write better CesiumJS code by providing API documentation lookup, code snippet generation, and Entity configuration building -- all through the MCP protocol.
+
+```
+IDE AI Assistant <--MCP stdio--> cesium-mcp-dev --> API docs, code snippets, Entity configs
+```
+
+## Install & Run
+
+```bash
+npx cesium-mcp-dev
+```
+
+## IDE Configuration
+
+### VS Code (Copilot)
+
+In `.vscode/mcp.json`:
+
+```json
+{
+  "servers": {
+    "cesium-dev": {
+      "command": "npx",
+      "args": ["cesium-mcp-dev"]
+    }
+  }
+}
+```
+
+### Cursor
+
+In `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "cesium-dev": {
+      "command": "npx",
+      "args": ["cesium-mcp-dev"]
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+```json
+{
+  "mcpServers": {
+    "cesium-dev": {
+      "command": "npx",
+      "args": ["cesium-mcp-dev"]
+    }
+  }
+}
+```
+
+## MCP Tools (3)
+
+### `cesium_api_lookup`
+
+Query Cesium API documentation by class name, method, or property.
+
+```
+Input: "Viewer"
+Output: Constructor signature, properties, methods, and usage examples
+```
+
+**Covered classes**: Viewer, Entity, Camera, Cartesian3, Color, GeoJsonDataSource, ImageryLayer, Cesium3DTileset, Material, ScreenSpaceEventHandler, flyTo, setView (12 classes)
+
+### `cesium_code_gen`
+
+Generate Cesium code from natural language descriptions.
+
+```
+Input: "Add a red point marker at Tiananmen Square"
+Output: Complete TypeScript code snippet ready to use
+```
+
+**Built-in snippets**: fly to location, add marker, load GeoJSON, draw polyline, draw polygon, load 3D Tiles, switch basemap, click handler, screenshot, heatmap, trajectory animation (11 scenarios)
+
+### `cesium_entity_builder`
+
+Build Entity configurations interactively by specifying type and properties.
+
+```
+Input: type: "polygon", position: {lon: 116.4, lat: 39.9}, color: "#ff6600"
+Output: Complete Entity definition with material, style, and ground clamping
+```
+
+**Supported types**: point, billboard, label, polyline, polygon, model, ellipse, box (8 types)
+
+## Example Interactions
+
+**AI assistant asks**: "How do I load a 3D Tiles model from Cesium Ion?"
+
+The assistant calls `cesium_api_lookup` with `"Cesium3DTileset"`, gets the API reference, then calls `cesium_code_gen` with the user's specific requirements to generate ready-to-use code.
+
+**AI assistant asks**: "Create an Entity for a semi-transparent blue polygon"
+
+The assistant calls `cesium_entity_builder` with `type: "polygon", color: "#0066ff", opacity: 0.5` and gets complete code output.
+
+## Compatibility
+
+| cesium-mcp-dev | Cesium |
+|----------------|--------|
+| 1.139.x | ~1.139.0 |
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/index.js

@@ -0,0 +1,683 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+// src/resources/api-docs.ts
+var CESIUM_API_DOCS = [
+  {
+    name: "Viewer",
+    category: "class",
+    description: "Cesium \u5E94\u7528\u7684\u6838\u5FC3\u5BB9\u5668\uFF0C\u7BA1\u7406\u6240\u6709 Cesium \u90E8\u4EF6\uFF08Scene, Camera, DataSources \u7B49\uFF09\u3002",
+    ctor: "new Cesium.Viewer(container: string | Element, options?: Viewer.ConstructorOptions)",
+    properties: ["scene", "camera", "entities", "dataSources", "imageryLayers", "clock", "canvas", "container"],
+    methods: ["flyTo(target)", "zoomTo(target)", "destroy()", "render()", "resize()"],
+    example: `const viewer = new Cesium.Viewer('cesiumContainer', {
+  terrain: Cesium.Terrain.fromWorldTerrain(),
+  baseLayerPicker: false,
+  geocoder: false,
+})`
+  },
+  {
+    name: "Entity",
+    category: "class",
+    description: "\u8868\u793A\u573A\u666F\u4E2D\u7684\u4E00\u4E2A\u7A7A\u95F4\u5BF9\u8C61\uFF0C\u53EF\u5305\u542B point, billboard, label, polyline, polygon, model \u7B49\u56FE\u5F62\u3002",
+    ctor: "new Cesium.Entity(options?: Entity.ConstructorOptions)",
+    properties: ["id", "name", "position", "description", "point", "billboard", "label", "polyline", "polygon", "model", "show"],
+    methods: ["isAvailable(time)", "merge(source)", "addProperty(name)"],
+    example: `viewer.entities.add({
+  name: 'My Point',
+  position: Cesium.Cartesian3.fromDegrees(116.4, 39.9, 0),
+  point: {
+    pixelSize: 10,
+    color: Cesium.Color.RED,
+  },
+})`
+  },
+  {
+    name: "Camera",
+    category: "class",
+    description: "\u573A\u666F\u7684\u865A\u62DF\u76F8\u673A\uFF0C\u63A7\u5236\u89C6\u89D2\u4F4D\u7F6E\u3001\u65B9\u5411\u548C\u89C6\u91CE\u3002",
+    ctor: "\uFF08\u901A\u8FC7 viewer.camera \u83B7\u53D6\uFF09",
+    properties: ["position", "direction", "up", "right", "heading", "pitch", "roll", "frustum"],
+    methods: ["flyTo(options)", "setView(options)", "lookAt(target, offset)", "zoomIn(amount)", "zoomOut(amount)", "flyHome(duration)"],
+    example: `viewer.camera.flyTo({
+  destination: Cesium.Cartesian3.fromDegrees(116.4, 39.9, 50000),
+  orientation: {
+    heading: Cesium.Math.toRadians(0),
+    pitch: Cesium.Math.toRadians(-45),
+    roll: 0,
+  },
+  duration: 2,
+})`
+  },
+  {
+    name: "Cartesian3",
+    category: "class",
+    description: "\u4E09\u7EF4\u7B1B\u5361\u5C14\u5750\u6807\u70B9\uFF0CCesium \u4E2D\u6700\u5E38\u7528\u7684\u4F4D\u7F6E\u8868\u793A\u3002",
+    ctor: "new Cesium.Cartesian3(x?: number, y?: number, z?: number)",
+    properties: ["x", "y", "z"],
+    methods: ["clone()", "equals(right)", "toString()"],
+    example: `// \u4ECE\u7ECF\u7EAC\u5EA6\u521B\u5EFA
+const position = Cesium.Cartesian3.fromDegrees(116.4, 39.9, 100)
+
+// \u4ECE\u5F27\u5EA6\u521B\u5EFA
+const pos2 = Cesium.Cartesian3.fromRadians(lon, lat, height)
+
+// \u8DDD\u79BB\u8BA1\u7B97
+const distance = Cesium.Cartesian3.distance(pos1, pos2)`
+  },
+  {
+    name: "Color",
+    category: "class",
+    description: "\u989C\u8272\u5BF9\u8C61\uFF0C\u652F\u6301 RGBA \u548C\u5404\u79CD\u9884\u8BBE\u989C\u8272\u5E38\u91CF\u3002",
+    ctor: "new Cesium.Color(red?: number, green?: number, blue?: number, alpha?: number)",
+    properties: ["red", "green", "blue", "alpha"],
+    methods: ["withAlpha(alpha)", "toCssColorString()", "toBytes()"],
+    example: `// \u9884\u8BBE\u989C\u8272
+Cesium.Color.RED
+Cesium.Color.BLUE.withAlpha(0.5)
+
+// CSS \u5B57\u7B26\u4E32
+Cesium.Color.fromCssColorString('#3388ff')
+Cesium.Color.fromCssColorString('rgba(255, 0, 0, 0.5)')`
+  },
+  {
+    name: "GeoJsonDataSource",
+    category: "class",
+    description: "\u52A0\u8F7D\u548C\u89E3\u6790 GeoJSON / TopoJSON \u6570\u636E\uFF0C\u81EA\u52A8\u521B\u5EFA\u5BF9\u5E94\u7684 Entity \u96C6\u5408\u3002",
+    ctor: "new Cesium.GeoJsonDataSource(name?: string)",
+    properties: ["name", "entities", "isLoading", "changedEvent"],
+    methods: ["load(data, options)", "process(data, options)"],
+    example: `const ds = await Cesium.GeoJsonDataSource.load('/data/boundary.geojson', {
+  stroke: Cesium.Color.fromCssColorString('#333'),
+  fill: Cesium.Color.BLUE.withAlpha(0.4),
+  strokeWidth: 2,
+  clampToGround: true,
+})
+viewer.dataSources.add(ds)
+viewer.flyTo(ds)`
+  },
+  {
+    name: "ImageryLayer",
+    category: "class",
+    description: "\u5F71\u50CF\u56FE\u5C42\uFF0C\u7BA1\u7406\u5E95\u56FE\u548C\u53E0\u52A0\u5F71\u50CF\u3002",
+    ctor: "\uFF08\u901A\u8FC7 viewer.imageryLayers.addImageryProvider \u521B\u5EFA\uFF09",
+    properties: ["imageryProvider", "alpha", "brightness", "contrast", "show"],
+    methods: ["isBaseLayer()", "destroy()"],
+    example: `// \u6DFB\u52A0 TMS \u5E95\u56FE
+const provider = new Cesium.UrlTemplateImageryProvider({
+  url: 'https://tile.openstreetmap.org/{z}/{x}/{y}.png',
+  maximumLevel: 18,
+})
+viewer.imageryLayers.addImageryProvider(provider)`
+  },
+  {
+    name: "Cesium3DTileset",
+    category: "class",
+    description: "\u52A0\u8F7D\u548C\u6E32\u67D3 3D Tiles \u6570\u636E\u96C6\uFF08\u5EFA\u7B51\u6A21\u578B\u3001\u70B9\u4E91\u7B49\uFF09\u3002",
+    ctor: "await Cesium.Cesium3DTileset.fromUrl(url, options)",
+    properties: ["root", "boundingSphere", "maximumScreenSpaceError", "show", "style"],
+    methods: ["makeStyleDirty()", "destroy()"],
+    example: `const tileset = await Cesium.Cesium3DTileset.fromUrl(
+  'https://assets.cesium.com/xxx/tileset.json',
+  { maximumScreenSpaceError: 16 }
+)
+viewer.scene.primitives.add(tileset)
+viewer.flyTo(tileset)`
+  },
+  {
+    name: "Material",
+    category: "class",
+    description: "\u5B9A\u4E49\u51E0\u4F55\u4F53\u8868\u9762\u7684\u6E32\u67D3\u6750\u8D28\uFF08\u989C\u8272\u3001\u7EB9\u7406\u3001\u53D1\u5149\u7B49\uFF09\u3002",
+    ctor: "\uFF08\u901A\u5E38\u901A\u8FC7 MaterialProperty \u914D\u7F6E\uFF09",
+    properties: ["type", "uniforms"],
+    methods: [],
+    example: `// \u6761\u7EB9\u6750\u8D28
+entity.polygon.material = new Cesium.StripeMaterialProperty({
+  evenColor: Cesium.Color.WHITE,
+  oddColor: Cesium.Color.BLUE,
+  repeat: 5,
+})
+
+// \u53D1\u5149\u7EBF
+entity.polyline.material = new Cesium.PolylineGlowMaterialProperty({
+  glowPower: 0.2,
+  color: Cesium.Color.CYAN,
+})`
+  },
+  {
+    name: "flyTo",
+    category: "method",
+    description: "Camera.flyTo \u2014 \u5E73\u6ED1\u98DE\u884C\u5230\u76EE\u6807\u4F4D\u7F6E\u3002",
+    example: `viewer.camera.flyTo({
+  destination: Cesium.Cartesian3.fromDegrees(116.4, 39.9, 15000),
+  orientation: {
+    heading: Cesium.Math.toRadians(0),
+    pitch: Cesium.Math.toRadians(-45),
+    roll: 0,
+  },
+  duration: 2,
+  complete: () => console.log('\u98DE\u884C\u5B8C\u6210'),
+})`
+  },
+  {
+    name: "setView",
+    category: "method",
+    description: "Camera.setView \u2014 \u7ACB\u5373\u8BBE\u7F6E\u76F8\u673A\u4F4D\u7F6E\uFF08\u65E0\u52A8\u753B\uFF09\u3002",
+    example: `viewer.camera.setView({
+  destination: Cesium.Cartesian3.fromDegrees(116.4, 39.9, 15000),
+  orientation: {
+    heading: 0,
+    pitch: -Cesium.Math.PI_OVER_FOUR,
+    roll: 0,
+  },
+})`
+  },
+  {
+    name: "ScreenSpaceEventHandler",
+    category: "class",
+    description: "\u5904\u7406\u7528\u6237\u8F93\u5165\u4E8B\u4EF6\uFF08\u9F20\u6807\u70B9\u51FB\u3001\u79FB\u52A8\u3001\u60AC\u505C\u7B49\uFF09\u3002",
+    ctor: "new Cesium.ScreenSpaceEventHandler(canvas)",
+    properties: [],
+    methods: ["setInputAction(action, type)", "removeInputAction(type)", "destroy()"],
+    example: `const handler = new Cesium.ScreenSpaceEventHandler(viewer.canvas)
+handler.setInputAction((movement: { position: Cesium.Cartesian2 }) => {
+  const picked = viewer.scene.pick(movement.position)
+  if (Cesium.defined(picked)) {
+    console.log('\u70B9\u51FB\u4E86:', picked.id?.name)
+  }
+}, Cesium.ScreenSpaceEventType.LEFT_CLICK)`
+  }
+];
+
+// src/resources/entity-templates.ts
+var ENTITY_TEMPLATES = {
+  point: {
+    defaultSize: 10,
+    generate: (p) => `viewer.entities.add({
+  name: '${p.name}',
+  position: Cesium.Cartesian3.fromDegrees(${p.lon}, ${p.lat}, ${p.height}),
+  point: {
+    pixelSize: ${p.size},
+    color: Cesium.Color.fromCssColorString('${p.color}'),
+    outlineColor: Cesium.Color.WHITE,
+    outlineWidth: 1,
+  },
+})`
+  },
+  billboard: {
+    defaultSize: 32,
+    generate: (p) => `viewer.entities.add({
+  name: '${p.name}',
+  position: Cesium.Cartesian3.fromDegrees(${p.lon}, ${p.lat}, ${p.height}),
+  billboard: {
+    image: 'path/to/icon.png',  // \u66FF\u6362\u4E3A\u5B9E\u9645\u56FE\u6807\u8DEF\u5F84
+    width: ${p.size},
+    height: ${p.size},
+    color: Cesium.Color.fromCssColorString('${p.color}'),
+    verticalOrigin: Cesium.VerticalOrigin.BOTTOM,
+    heightReference: Cesium.HeightReference.CLAMP_TO_GROUND,
+  },
+})`
+  },
+  label: {
+    defaultSize: 14,
+    generate: (p) => `viewer.entities.add({
+  name: '${p.name}',
+  position: Cesium.Cartesian3.fromDegrees(${p.lon}, ${p.lat}, ${p.height}),
+  label: {
+    text: '${p.name}',
+    font: '${p.size}px sans-serif',
+    fillColor: Cesium.Color.fromCssColorString('${p.color}'),
+    style: Cesium.LabelStyle.FILL_AND_OUTLINE,
+    outlineWidth: 2,
+    outlineColor: Cesium.Color.BLACK,
+    verticalOrigin: Cesium.VerticalOrigin.BOTTOM,
+    pixelOffset: new Cesium.Cartesian2(0, -10),
+    heightReference: Cesium.HeightReference.CLAMP_TO_GROUND,
+  },
+})`
+  },
+  polyline: {
+    defaultSize: 3,
+    generate: (p) => `viewer.entities.add({
+  name: '${p.name}',
+  polyline: {
+    positions: Cesium.Cartesian3.fromDegreesArray([
+      ${p.lon}, ${p.lat},
+      ${p.lon + 0.01}, ${p.lat + 0.01},  // \u66FF\u6362\u4E3A\u5B9E\u9645\u5750\u6807
+    ]),
+    width: ${p.size},
+    material: Cesium.Color.fromCssColorString('${p.color}'),
+    clampToGround: true,
+  },
+})`
+  },
+  polygon: {
+    defaultSize: 0,
+    generate: (p) => `viewer.entities.add({
+  name: '${p.name}',
+  polygon: {
+    hierarchy: Cesium.Cartesian3.fromDegreesArray([
+      ${p.lon - 5e-3}, ${p.lat - 5e-3},
+      ${p.lon + 5e-3}, ${p.lat - 5e-3},
+      ${p.lon + 5e-3}, ${p.lat + 5e-3},
+      ${p.lon - 5e-3}, ${p.lat + 5e-3},
+    ]),
+    material: Cesium.Color.fromCssColorString('${p.color}').withAlpha(0.4),
+    outline: true,
+    outlineColor: Cesium.Color.fromCssColorString('${p.color}'),
+    heightReference: Cesium.HeightReference.CLAMP_TO_GROUND,
+  },
+})`
+  },
+  model: {
+    defaultSize: 1,
+    generate: (p) => `viewer.entities.add({
+  name: '${p.name}',
+  position: Cesium.Cartesian3.fromDegrees(${p.lon}, ${p.lat}, ${p.height}),
+  model: {
+    uri: 'path/to/model.glb',  // \u66FF\u6362\u4E3A\u5B9E\u9645\u6A21\u578B\u8DEF\u5F84
+    scale: ${p.size},
+    minimumPixelSize: 64,
+    color: Cesium.Color.fromCssColorString('${p.color}'),
+    colorBlendMode: Cesium.ColorBlendMode.MIX,
+    colorBlendAmount: 0.5,
+  },
+})`
+  },
+  ellipse: {
+    defaultSize: 500,
+    generate: (p) => `viewer.entities.add({
+  name: '${p.name}',
+  position: Cesium.Cartesian3.fromDegrees(${p.lon}, ${p.lat}, ${p.height}),
+  ellipse: {
+    semiMajorAxis: ${p.size},
+    semiMinorAxis: ${p.size * 0.7},
+    material: Cesium.Color.fromCssColorString('${p.color}').withAlpha(0.3),
+    outline: true,
+    outlineColor: Cesium.Color.fromCssColorString('${p.color}'),
+    heightReference: Cesium.HeightReference.CLAMP_TO_GROUND,
+  },
+})`
+  },
+  box: {
+    defaultSize: 100,
+    generate: (p) => `viewer.entities.add({
+  name: '${p.name}',
+  position: Cesium.Cartesian3.fromDegrees(${p.lon}, ${p.lat}, ${p.height + p.size / 2}),
+  box: {
+    dimensions: new Cesium.Cartesian3(${p.size}, ${p.size}, ${p.size}),
+    material: Cesium.Color.fromCssColorString('${p.color}').withAlpha(0.6),
+    outline: true,
+    outlineColor: Cesium.Color.fromCssColorString('${p.color}'),
+  },
+})`
+  }
+};
+
+// src/resources/code-snippets.ts
+var CODE_SNIPPETS = [
+  {
+    title: "\u98DE\u884C\u5230\u6307\u5B9A\u4F4D\u7F6E",
+    keywords: ["\u98DE\u5230", "\u98DE\u884C", "flyto", "\u89C6\u89D2", "\u5B9A\u4F4D"],
+    code: `viewer.camera.flyTo({
+  destination: Cesium.Cartesian3.fromDegrees(116.397, 39.908, 15000),
+  orientation: {
+    heading: Cesium.Math.toRadians(0),
+    pitch: Cesium.Math.toRadians(-45),
+    roll: 0,
+  },
+  duration: 2,
+})`
+  },
+  {
+    title: "\u6DFB\u52A0\u70B9\u6807\u8BB0",
+    keywords: ["\u6807\u8BB0", "marker", "\u70B9", "point", "\u56FE\u9489", "pin"],
+    code: `const entity: Cesium.Entity = viewer.entities.add({
+  name: '\u6211\u7684\u6807\u8BB0',
+  position: Cesium.Cartesian3.fromDegrees(116.397, 39.908, 0),
+  point: {
+    pixelSize: 12,
+    color: Cesium.Color.RED,
+    outlineColor: Cesium.Color.WHITE,
+    outlineWidth: 2,
+    heightReference: Cesium.HeightReference.CLAMP_TO_GROUND,
+  },
+  label: {
+    text: '\u5929\u5B89\u95E8',
+    font: '14px sans-serif',
+    pixelOffset: new Cesium.Cartesian2(0, -20),
+    fillColor: Cesium.Color.WHITE,
+    style: Cesium.LabelStyle.FILL_AND_OUTLINE,
+    outlineWidth: 2,
+    outlineColor: Cesium.Color.BLACK,
+  },
+})`
+  },
+  {
+    title: "\u52A0\u8F7D GeoJSON \u6570\u636E",
+    keywords: ["geojson", "\u56FE\u5C42", "layer", "\u52A0\u8F7D", "load", "\u6570\u636E"],
+    code: `const dataSource: Cesium.GeoJsonDataSource = await Cesium.GeoJsonDataSource.load(
+  '/path/to/data.geojson',
+  {
+    stroke: Cesium.Color.fromCssColorString('#3388ff'),
+    fill: Cesium.Color.fromCssColorString('#3388ff').withAlpha(0.3),
+    strokeWidth: 2,
+    clampToGround: true,
+  }
+)
+viewer.dataSources.add(dataSource)
+await viewer.flyTo(dataSource)`
+  },
+  {
+    title: "\u7ED8\u5236\u6298\u7EBF",
+    keywords: ["\u7EBF", "line", "polyline", "\u6298\u7EBF", "\u8DEF\u5F84", "\u8DEF\u7EBF"],
+    code: `viewer.entities.add({
+  name: '\u6211\u7684\u8DEF\u7EBF',
+  polyline: {
+    positions: Cesium.Cartesian3.fromDegreesArray([
+      116.39, 39.91,
+      116.40, 39.90,
+      116.41, 39.92,
+    ]),
+    width: 3,
+    material: new Cesium.PolylineGlowMaterialProperty({
+      glowPower: 0.2,
+      color: Cesium.Color.CYAN,
+    }),
+    clampToGround: true,
+  },
+})`
+  },
+  {
+    title: "\u7ED8\u5236\u591A\u8FB9\u5F62",
+    keywords: ["\u591A\u8FB9\u5F62", "polygon", "\u9762", "\u533A\u57DF", "\u8303\u56F4"],
+    code: `viewer.entities.add({
+  name: '\u6211\u7684\u533A\u57DF',
+  polygon: {
+    hierarchy: Cesium.Cartesian3.fromDegreesArray([
+      116.38, 39.90,
+      116.42, 39.90,
+      116.42, 39.93,
+      116.38, 39.93,
+    ]),
+    material: Cesium.Color.fromCssColorString('#ff6600').withAlpha(0.3),
+    outline: true,
+    outlineColor: Cesium.Color.fromCssColorString('#ff6600'),
+    outlineWidth: 2,
+    heightReference: Cesium.HeightReference.CLAMP_TO_GROUND,
+  },
+})`
+  },
+  {
+    title: "\u52A0\u8F7D 3D Tiles",
+    keywords: ["3d", "tiles", "3dtiles", "\u6A21\u578B", "\u5EFA\u7B51", "tileset"],
+    code: `const tileset: Cesium.Cesium3DTileset = await Cesium.Cesium3DTileset.fromUrl(
+  'https://assets.cesium.com/your-asset-id/tileset.json',
+  {
+    maximumScreenSpaceError: 16,
+    maximumMemoryUsage: 512,
+  }
+)
+viewer.scene.primitives.add(tileset)
+
+// \u53EF\u9009\uFF1A\u8BBE\u7F6E 3D Tiles \u6837\u5F0F
+tileset.style = new Cesium.Cesium3DTileStyle({
+  color: "color('white')",
+  show: true,
+})
+
+await viewer.flyTo(tileset)`
+  },
+  {
+    title: "\u5207\u6362\u5E95\u56FE",
+    keywords: ["\u5E95\u56FE", "basemap", "\u5F71\u50CF", "\u536B\u661F", "imagery"],
+    code: `// \u79FB\u9664\u5F53\u524D\u5E95\u56FE
+viewer.imageryLayers.removeAll()
+
+// \u6DFB\u52A0\u65B0\u5E95\u56FE \u2014 OpenStreetMap
+viewer.imageryLayers.addImageryProvider(
+  new Cesium.UrlTemplateImageryProvider({
+    url: 'https://tile.openstreetmap.org/{z}/{x}/{y}.png',
+    maximumLevel: 18,
+    credit: new Cesium.Credit('OpenStreetMap'),
+  })
+)
+
+// \u6216\u4F7F\u7528 Cesium Ion \u5E95\u56FE
+// viewer.imageryLayers.addImageryProvider(
+//   await Cesium.IonImageryProvider.fromAssetId(3)  // Bing Maps
+// )`
+  },
+  {
+    title: "\u9F20\u6807\u70B9\u51FB\u62FE\u53D6",
+    keywords: ["\u70B9\u51FB", "click", "\u62FE\u53D6", "pick", "\u9009\u62E9", "\u4EA4\u4E92"],
+    code: `const handler: Cesium.ScreenSpaceEventHandler = new Cesium.ScreenSpaceEventHandler(viewer.canvas)
+
+handler.setInputAction((movement: { position: Cesium.Cartesian2 }) => {
+  // \u62FE\u53D6 Entity
+  const picked = viewer.scene.pick(movement.position)
+  if (Cesium.defined(picked) && picked.id instanceof Cesium.Entity) {
+    console.log('\u9009\u4E2D:', picked.id.name)
+    viewer.selectedEntity = picked.id
+  }
+
+  // \u83B7\u53D6\u5730\u7406\u5750\u6807
+  const cartesian = viewer.camera.pickEllipsoid(movement.position)
+  if (cartesian) {
+    const carto = Cesium.Cartographic.fromCartesian(cartesian)
+    const lon = Cesium.Math.toDegrees(carto.longitude)
+    const lat = Cesium.Math.toDegrees(carto.latitude)
+    console.log(\`\u5750\u6807: \${lon.toFixed(6)}, \${lat.toFixed(6)}\`)
+  }
+}, Cesium.ScreenSpaceEventType.LEFT_CLICK)
+
+// \u6E05\u7406: handler.destroy()`
+  },
+  {
+    title: "\u622A\u56FE\u5BFC\u51FA",
+    keywords: ["\u622A\u56FE", "screenshot", "\u5BFC\u51FA", "\u56FE\u7247", "canvas"],
+    code: `// \u65B9\u6CD5 1: \u4F7F\u7528 canvas toDataURL
+viewer.render()
+const dataUrl: string = viewer.canvas.toDataURL('image/png')
+
+// \u65B9\u6CD5 2: \u4E0B\u8F7D
+const link = document.createElement('a')
+link.download = 'cesium-screenshot.png'
+link.href = dataUrl
+link.click()`
+  },
+  {
+    title: "\u70ED\u529B\u56FE\u6548\u679C",
+    keywords: ["\u70ED\u529B", "heatmap", "\u70ED\u529B\u56FE", "\u5BC6\u5EA6"],
+    code: `// \u4F7F\u7528 canvas \u751F\u6210\u70ED\u529B\u56FE\u7EB9\u7406\u53E0\u52A0
+// \u9700\u8981 heatmap.js \u6216\u81EA\u5B9A\u4E49\u5B9E\u73B0
+
+// \u7B80\u5355\u7684\u70B9\u5BC6\u5EA6\u53EF\u89C6\u5316\uFF08\u4F7F\u7528\u4E0D\u540C\u5927\u5C0F\u7684\u70B9\uFF09
+const points = [
+  { lon: 116.39, lat: 39.91, weight: 0.8 },
+  { lon: 116.40, lat: 39.90, weight: 0.5 },
+  { lon: 116.41, lat: 39.92, weight: 1.0 },
+]
+
+for (const p of points) {
+  viewer.entities.add({
+    position: Cesium.Cartesian3.fromDegrees(p.lon, p.lat),
+    point: {
+      pixelSize: 10 + p.weight * 30,
+      color: Cesium.Color.RED.withAlpha(0.3 + p.weight * 0.4),
+      heightReference: Cesium.HeightReference.CLAMP_TO_GROUND,
+    },
+  })
+}`
+  },
+  {
+    title: "\u65F6\u95F4\u52A8\u753B/\u8F68\u8FF9\u64AD\u653E",
+    keywords: ["\u52A8\u753B", "animation", "\u8F68\u8FF9", "trajectory", "\u65F6\u95F4", "clock", "\u64AD\u653E"],
+    code: `// \u8BBE\u7F6E\u65F6\u949F
+const start = Cesium.JulianDate.fromIso8601('2024-01-01T00:00:00Z')
+const stop = Cesium.JulianDate.addHours(start, 1, new Cesium.JulianDate())
+
+viewer.clock.startTime = start.clone()
+viewer.clock.stopTime = stop.clone()
+viewer.clock.currentTime = start.clone()
+viewer.clock.multiplier = 60  // 60x \u901F\u5EA6
+
+// \u521B\u5EFA\u91C7\u6837\u4F4D\u7F6E
+const positionProperty = new Cesium.SampledPositionProperty()
+positionProperty.addSample(start,
+  Cesium.Cartesian3.fromDegrees(116.39, 39.90, 100))
+positionProperty.addSample(stop,
+  Cesium.Cartesian3.fromDegrees(116.42, 39.93, 100))
+
+// \u6DFB\u52A0\u8FD0\u52A8\u5B9E\u4F53
+viewer.entities.add({
+  name: '\u79FB\u52A8\u76EE\u6807',
+  position: positionProperty,
+  point: { pixelSize: 8, color: Cesium.Color.YELLOW },
+  path: {
+    resolution: 1,
+    material: Cesium.Color.CYAN.withAlpha(0.5),
+    width: 2,
+    leadTime: 0,
+    trailTime: 3600,
+  },
+})`
+  }
+];
+
+// src/index.ts
+var server = new McpServer({
+  name: "cesium-mcp-dev",
+  version: "0.1.0"
+});
+server.tool(
+  "cesium_api_lookup",
+  "\u67E5\u8BE2 Cesium API \u6587\u6863\u3002\u8F93\u5165\u7C7B\u540D\u6216\u5173\u952E\u8BCD\uFF0C\u8FD4\u56DE\u5BF9\u5E94\u7684 API \u63CF\u8FF0\u3001\u6784\u9020\u53C2\u6570\u3001\u5E38\u7528\u65B9\u6CD5\u548C\u793A\u4F8B\u4EE3\u7801\u3002",
+  {
+    query: z.string().describe('Cesium \u7C7B\u540D\u6216\u5173\u952E\u8BCD\uFF0C\u5982 "Viewer"\u3001"Entity"\u3001"Color"\u3001"flyTo"'),
+    category: z.enum(["class", "method", "property", "all"]).default("all").describe("\u67E5\u8BE2\u7C7B\u522B")
+  },
+  async ({ query, category }) => {
+    const q = query.toLowerCase();
+    const matches = CESIUM_API_DOCS.filter((doc) => {
+      const nameMatch = doc.name.toLowerCase().includes(q);
+      const descMatch = doc.description.toLowerCase().includes(q);
+      const catMatch = category === "all" || doc.category === category;
+      return (nameMatch || descMatch) && catMatch;
+    }).slice(0, 5);
+    if (matches.length === 0) {
+      return {
+        content: [{
+          type: "text",
+          text: `\u672A\u627E\u5230\u4E0E "${query}" \u5339\u914D\u7684 Cesium API\u3002
+
+\u53EF\u7528\u7684\u70ED\u95E8\u7C7B\uFF1AViewer, Entity, Camera, Color, Cartesian3, GeoJsonDataSource, ImageryLayer, Terrain, Material, Clock`
+        }]
+      };
+    }
+    const text = matches.map(
+      (doc) => `## ${doc.name}
+**\u7C7B\u522B**: ${doc.category}
+**\u63CF\u8FF0**: ${doc.description}
+` + (doc.ctor ? `**\u6784\u9020\u51FD\u6570**: \`${doc.ctor}\`
+` : "") + (doc.properties?.length ? `**\u5E38\u7528\u5C5E\u6027**: ${doc.properties.join(", ")}
+` : "") + (doc.methods?.length ? `**\u5E38\u7528\u65B9\u6CD5**: ${doc.methods.join(", ")}
+` : "") + (doc.example ? `
+\`\`\`typescript
+${doc.example}
+\`\`\`
+` : "")
+    ).join("\n---\n\n");
+    return { content: [{ type: "text", text }] };
+  }
+);
+server.tool(
+  "cesium_code_gen",
+  "\u6839\u636E\u81EA\u7136\u8BED\u8A00\u63CF\u8FF0\u751F\u6210 Cesium \u4EE3\u7801\u7247\u6BB5\u3002\u652F\u6301\u5E38\u89C1\u573A\u666F\uFF1A\u89C6\u56FE\u63A7\u5236\u3001\u56FE\u5C42\u52A0\u8F7D\u3001Entity \u521B\u5EFA\u3001\u6837\u5F0F\u8BBE\u7F6E\u7B49\u3002",
+  {
+    description: z.string().describe('\u7528\u81EA\u7136\u8BED\u8A00\u63CF\u8FF0\u9700\u8981\u5B9E\u73B0\u7684\u529F\u80FD\uFF0C\u5982 "\u521B\u5EFA\u4E00\u4E2A\u7EA2\u8272\u7684\u70B9\u6807\u8BB0\u5728\u5929\u5B89\u95E8"'),
+    language: z.enum(["typescript", "javascript"]).default("typescript").describe("\u4EE3\u7801\u8BED\u8A00")
+  },
+  async ({ description, language }) => {
+    const desc = description.toLowerCase();
+    const matched = CODE_SNIPPETS.filter(
+      (s) => s.keywords.some((k) => desc.includes(k))
+    );
+    if (matched.length === 0) {
+      const fallback = `// Cesium \u4EE3\u7801\u751F\u6210
+// \u63CF\u8FF0: ${description}
+// 
+// \u63D0\u793A: \u5C1D\u8BD5\u4F7F\u7528\u66F4\u5177\u4F53\u7684\u5173\u952E\u8BCD\uFF0C\u5982:
+// - "\u98DE\u5230" / "flyTo" \u2014 \u89C6\u56FE\u98DE\u884C
+// - "\u6807\u8BB0" / "marker" / "\u70B9" \u2014 \u6DFB\u52A0\u6807\u8BB0
+// - "GeoJSON" / "\u56FE\u5C42" \u2014 \u52A0\u8F7D\u6570\u636E
+// - "\u70ED\u529B\u56FE" / "heatmap" \u2014 \u70ED\u529B\u53EF\u89C6\u5316
+// - "\u5E95\u56FE" / "basemap" \u2014 \u5207\u6362\u5E95\u56FE
+// - "3D Tiles" \u2014 \u52A0\u8F7D 3D \u6A21\u578B`;
+      return { content: [{ type: "text", text: fallback }] };
+    }
+    const text = matched.slice(0, 3).map((s) => {
+      let code = s.code;
+      if (language === "javascript") {
+        code = code.replace(/: Cesium\.\w+/g, "").replace(/: string/g, "").replace(/: number/g, "").replace(/: boolean/g, "").replace(/as \w+/g, "");
+      }
+      return `### ${s.title}
+
+\`\`\`${language}
+${code}
+\`\`\``;
+    }).join("\n\n");
+    return { content: [{ type: "text", text }] };
+  }
+);
+server.tool(
+  "cesium_entity_builder",
+  "\u4EA4\u4E92\u5F0F\u6784\u5EFA Cesium Entity \u914D\u7F6E\u3002\u9009\u62E9 Entity \u7C7B\u578B\uFF08point/billboard/label/polyline/polygon/model\uFF09\uFF0C\u8FD4\u56DE\u5B8C\u6574\u7684 Entity JSON \u914D\u7F6E\u548C\u521B\u5EFA\u4EE3\u7801\u3002",
+  {
+    type: z.enum(["point", "billboard", "label", "polyline", "polygon", "model", "ellipse", "box"]).describe("Entity \u56FE\u5F62\u7C7B\u578B"),
+    name: z.string().optional().describe("Entity \u540D\u79F0"),
+    position: z.object({
+      longitude: z.number(),
+      latitude: z.number(),
+      height: z.number().default(0)
+    }).optional().describe("\u4F4D\u7F6E\uFF08\u7ECF\u7EAC\u5EA6\uFF09"),
+    color: z.string().default("#FF0000").describe("\u989C\u8272\uFF08CSS \u683C\u5F0F\uFF09"),
+    size: z.number().optional().describe("\u5C3A\u5BF8\uFF08\u50CF\u7D20\u6216\u7C73\uFF09")
+  },
+  async ({ type, name, position, color, size }) => {
+    const template = ENTITY_TEMPLATES[type];
+    if (!template) {
+      return { content: [{ type: "text", text: `\u4E0D\u652F\u6301\u7684 Entity \u7C7B\u578B: ${type}` }] };
+    }
+    const entityName = name || `My ${type.charAt(0).toUpperCase() + type.slice(1)}`;
+    const lon = position?.longitude ?? 116.397;
+    const lat = position?.latitude ?? 39.908;
+    const h = position?.height ?? 0;
+    const entitySize = size ?? template.defaultSize;
+    const code = template.generate({ name: entityName, lon, lat, height: h, color, size: entitySize });
+    const text = `## Entity: ${entityName}
+**\u7C7B\u578B**: ${type}
+**\u4F4D\u7F6E**: ${lon}, ${lat}, ${h}m
+**\u989C\u8272**: ${color}
+**\u5C3A\u5BF8**: ${entitySize}
+
+\`\`\`typescript
+${code}
+\`\`\``;
+    return { content: [{ type: "text", text }] };
+  }
+);
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error(`[cesium-mcp-dev] MCP Server running (stdio), 3 tools registered`);
+}
+main().catch((err) => {
+  console.error("[cesium-mcp-dev] Fatal:", err);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "cesium-mcp-dev",
+  "version": "1.139.0",
+  "description": "Cesium MCP for Development — IDE AI 助手的 Cesium API 文档查询与代码生成",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "cesium-mcp-dev": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsup"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.5.1",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gaopengbin/cesium-mcp.git",
+    "directory": "packages/cesium-mcp-dev"
+  },
+  "homepage": "https://github.com/gaopengbin/cesium-mcp/tree/main/packages/cesium-mcp-dev",
+  "license": "MIT"
+}