Merge pull request #22 from gaopengbin/feat/imagery-server

feat: add imagery-server with imagery_add, imagery_remove, imagery_list tools

Author: MKartaviciute

mcp/README.md

@@ -13,6 +13,7 @@ CesiumJs servers live in [`cesium-js/`](./cesium-js/README.md). See the [cesium-
 | 🎥 [cesium-camera-server](./cesium-js/servers/camera-server/README.md) | `cesium-js/servers/camera-server/` | Camera control: fly-to, orbit, look-at, position queries |
 | 🌍 [cesium-entity-server](./cesium-js/servers/entity-server/README.md) | `cesium-js/servers/entity-server/` | Entity management: points, billboards, labels, models, polygons, polylines, and more |
 | 🎬 [cesium-animation-server](./cesium-js/servers/animation-server/README.md) | `cesium-js/servers/animation-server/` | Path-based animations, clock control, camera tracking, globe lighting |
+| 🗺️ [cesium-imagery-server](./cesium-js/servers/imagery-server/README.md) | `cesium-js/servers/imagery-server/` | Imagery layer management: add, remove, and list imagery providers |
 
 ### 🌐 Geolocation MCP Server
 
@@ -43,6 +44,7 @@ See the individual READMEs for full details:
 - **[cesium-camera-server README](./cesium-js/servers/camera-server/README.md)** — camera tools reference and configuration
 - **[cesium-entity-server README](./cesium-js/servers/entity-server/README.md)** — entity tools reference and configuration
 - **[cesium-animation-server README](./cesium-js/servers/animation-server/README.md)** — animation tools reference and configuration
+- **[cesium-imagery-server README](./cesium-js/servers/imagery-server/README.md)** — imagery tools reference and configuration
 - **[cesium-geolocation-server README](./geolocation-server/README.md)** — geolocation, POI search, and routing tools
 - **[mcp-apps README](./mcp-apps/README.md)** — MCP Apps with interactive UIs
 - **[cesium-context7 README](./external/cesium-context7/README.md)** — Context7 setup and agent skill usage
@@ -60,7 +62,8 @@ mcp/
 │   │   ├── shared/              # Shared utilities (MCP base, communications)
 │   │   ├── camera-server/       # Camera control MCP server
 │   │   ├── entity-server/       # Entity management MCP server
-│   │   └── animation-server/    # Animation and path control MCP server
+│   │   ├── animation-server/    # Animation and path control MCP server
+│   │   └── imagery-server/      # Imagery layer management MCP server
 │   ├── test-applications/
 │   │   ├── packages/client-core/  # Shared client library
 │   │   └── web-app/              # Browser application (localhost:8080)

mcp/cesium-js/README.md

@@ -10,6 +10,7 @@ pnpm monorepo containing MCP servers and test applications for controlling [Cesi
 | [`@cesium-mcp/camera-server`](./servers/camera-server/README.md)                | Camera control: fly-to, orbit, look-at, position queries                             | 3002 |
 | [`@cesium-mcp/entity-server`](./servers/entity-server/README.md)                | Entity management: points, billboards, labels, models, polygons, polylines, and more | 3003 |
 | [`@cesium-mcp/animation-server`](./servers/animation-server/README.md)          | Path-based animations, clock control, camera tracking, globe lighting                | 3004 |
+| [`@cesium-mcp/imagery-server`](./servers/imagery-server/README.md)              | Imagery layer management: add, remove, and list imagery providers                    | 3005 |
 | [`@cesium-mcp/client-core`](./test-applications/packages/client-core/README.md) | Shared browser client library (managers, communications)                             | —    |
 | [`@cesium-mcp/cesium-js`](./test-applications/README.md)                        | Browser web application (CesiumJS viewer)                                            | 8080 |
 
@@ -65,6 +66,16 @@ Animate 3D models along paths and control the scene clock.
 | `clock_control`             | Configure global clock time, speed, and playback state       |
 | `globe_set_lighting`        | Enable realistic day/night globe lighting                    |
 
+### 🗺️ [cesium-imagery-server](./servers/imagery-server/README.md)
+
+Manage imagery layers on the CesiumJS globe.
+
+| Tool             | Description                                               |
+| ---------------- | --------------------------------------------------------- |
+| `imagery_add`    | Add imagery layer from various provider types             |
+| `imagery_remove` | Remove imagery layer by index, name, or remove all        |
+| `imagery_list`   | List all imagery layers with visibility and provider info |
+
 ## 🏗️ Structure
 
 ```
@@ -73,7 +84,8 @@ cesium-js/
 │   ├── shared/              # @cesium-mcp/shared
 │   ├── camera-server/       # @cesium-mcp/camera-server
 │   ├── entity-server/       # @cesium-mcp/entity-server
-│   └── animation-server/    # @cesium-mcp/animation-server
+│   ├── animation-server/    # @cesium-mcp/animation-server
+│   └── imagery-server/      # @cesium-mcp/imagery-server
 ├── test-applications/
 │   ├── packages/
 │   │   └── client-core/     # @cesium-mcp/client-core
@@ -107,6 +119,7 @@ pnpm run build:shared       # @cesium-mcp/shared only
 pnpm run build:camera       # @cesium-mcp/camera-server only
 pnpm run build:entity       # @cesium-mcp/entity-server only
 pnpm run build:animation    # @cesium-mcp/animation-server only
+pnpm run build:imagery      # @cesium-mcp/imagery-server only
 pnpm run build:cesium-js    # @cesium-mcp/cesium-js (web app) only
 pnpm run clean              # Remove all build artifacts
 ```
@@ -119,6 +132,7 @@ pnpm run clean              # Remove all build artifacts
 pnpm run dev:camera        # Camera server on port 3002
 pnpm run dev:entity        # Entity server on port 3003
 pnpm run dev:animation     # Animation server on port 3004
+pnpm run dev:imagery       # Imagery server on port 3005
 ```
 
 ### Web Application
@@ -168,6 +182,17 @@ Add the servers to your MCP client (e.g., Claude Desktop, Cline):
         "ANIMATION_SERVER_PORT": "3004",
         "STRICT_PORT": "false"
       }
+    },
+    "cesium-imagery": {
+      "command": "node",
+      "args": [
+        "{YOUR_WORKSPACE}/mcp/cesium-js/servers/imagery-server/build/index.js"
+      ],
+      "env": {
+        "COMMUNICATION_PROTOCOL": "websocket",
+        "IMAGERY_SERVER_PORT": "3005",
+        "STRICT_PORT": "false"
+      }
     }
   }
 }
@@ -186,7 +211,7 @@ Add the servers to your MCP client (e.g., Claude Desktop, Cline):
 AI Assistant (Claude, Cline, etc.)
         │  stdio (MCP)
         ▼
-  MCP Server (camera / entity / animation)
+  MCP Server (camera / entity / animation / imagery)
         │  WebSocket or SSE
         ▼
  CesiumJS Web App (localhost:8080)

mcp/cesium-js/package.json

@@ -5,15 +5,17 @@
   "type": "module",
   "private": true,
   "scripts": {
-    "build": "pnpm run build:shared && pnpm run build:camera && pnpm run build:entity && pnpm run build:animation && pnpm run build:cesium-js",
+    "build": "pnpm run build:shared && pnpm run build:camera && pnpm run build:entity && pnpm run build:animation && pnpm run build:imagery && pnpm run build:cesium-js",
     "build:shared": "pnpm --filter @cesium-mcp/shared build",
     "build:camera": "pnpm --filter @cesium-mcp/camera-server build",
     "build:entity": "pnpm --filter @cesium-mcp/entity-server build",
     "build:animation": "pnpm --filter @cesium-mcp/animation-server build",
+    "build:imagery": "pnpm --filter @cesium-mcp/imagery-server build",
     "build:cesium-js": "pnpm --filter @cesium-mcp/cesium-js build",
     "dev:camera": "pnpm --filter @cesium-mcp/camera-server dev",
     "dev:entity": "pnpm --filter @cesium-mcp/entity-server dev",
     "dev:animation": "pnpm --filter @cesium-mcp/animation-server dev",
+    "dev:imagery": "pnpm --filter @cesium-mcp/imagery-server dev",
     "start:web": "pnpm --filter @cesium-mcp/cesium-js start:web",
     "clean": "pnpm -r run clean",
     "lint": "eslint .",
@@ -25,7 +27,8 @@
     "test:coverage": "vitest run --coverage",
     "test:camera": "pnpm --filter @cesium-mcp/camera-server test",
     "test:entity": "pnpm --filter @cesium-mcp/entity-server test",
-    "test:animation": "pnpm --filter @cesium-mcp/animation-server test"
+    "test:animation": "pnpm --filter @cesium-mcp/animation-server test",
+    "test:imagery": "pnpm --filter @cesium-mcp/imagery-server test"
   },
   "keywords": [
     "mcp",

mcp/cesium-js/pnpm-lock.yaml

@@ -0,0 +1,5 @@
+IMAGERY_SERVER_PORT=3005
+MAX_RETRIES=10
+COMMUNICATION_PROTOCOL=websocket
+STRICT_PORT=false
+MCP_TRANSPORT=stdio