我应该用哪种模式?
cesium-mcp 提供 四种接入路径,它们共享同一套 Cesium 命令执行层。选择的关键是智能体在哪里运行,以及模型连接由谁管理。
决策树
text
你想做什么?
│
├─ 让兼容的浏览器智能体调用当前页面里的工具
│ └─→ 路径 1:WebMCP
│
├─ 用现成聊天界面快速体验 AI + Cesium
│ └─→ 路径 2:在线 Browser Agent
│
├─ 在已有 Web 应用中嵌入自己的 AI 助手
│ └─→ 路径 3:Bridge + function calling
│
└─ 从 Claude Desktop、Cursor、VS Code、Dify 或 n8n 调用 Cesium
└─→ 路径 4:MCP runtime四种模式对比
| 维度 | WebMCP | 在线 Browser Agent | Function calling | MCP runtime |
|---|---|---|---|---|
| 智能体运行位置 | 兼容浏览器 | Web 应用 | 你的 Web 应用 | 桌面客户端或工作流平台 |
| 是否需要 MCP 服务 | 否 | 否 | 否 | 是 |
| 包是否要求模型 | 否 | 演示站提供 | 是,由应用管理 | 由 MCP 客户端管理 |
| 工具范围 | 15 个核心或 61 个浏览器安全工具 | 自动调度至多 20 个,也可选择全部 61 个 + 61 个 WebMCP 工具 | 应用自行选择 | Runtime 工具集 |
| 最适合 | 面向智能体的网站 | 体验和演示 | 产品内 AI 助手 | 接入 MCP 生态 |
| 从这里开始 | WebMCP 指南 | 在线体验 | Browser Agent 源码 | 快速开始 |
路径 1:WebMCP
在页面中安装 cesium-mcp-webmcp,把工具注册到 document.modelContext。兼容的浏览器智能体可以发现并执行这些工具,不需要后端 MCP 服务。
适合以下场景:
- 希望网站本身向浏览器智能体暴露 Cesium 能力。
- 不希望每个用户都启动
cesium-mcp-runtime。 - 应用在不支持 WebMCP 的浏览器中仍然可以正常使用。
WebMCP 不提供 AI 模型或聊天界面。接入步骤见 WebMCP 浏览器接入。
路径 2:在线 Browser Agent
打开 Cesium Agent Lab,无需安装本地 MCP 服务即可体验自然语言控制地图。演示中的内置 AI 聊天和 WebMCP 工具注册是两个独立功能。
适合产品体验、教学、演示和参考部署。
路径 3:Bridge + function calling
使用 cesium-mcp-bridge 作为执行层,自行接入模型服务和 agent loop。
适合需要完全控制提示词、模型选择、身份认证、工具范围、日志和用量限制的产品。模型 API key 应放在你自己的服务端 /api/chat 接口后面,不要暴露在浏览器中。
路径 4:MCP runtime
bash
npx cesium-mcp-runtime
npx cesium-mcp-runtime --transport http --port 3211适合 Claude Desktop、Cursor、VS Code、Dify、n8n 或其他外部 MCP 客户端。这条路径会运行 Node.js MCP 服务,并通过 WebSocket 连接浏览器 Bridge。
还在犹豫?
先打开 在线演示 体验。如果目标是让自己的网站可被浏览器智能体发现,继续阅读 WebMCP 指南;如果需要外部 MCP 客户端控制地球,则使用 MCP runtime。