关于 EOxElements
EOxElements 是 EOX 开发的地理空间 Web Component 组件库,包含地图、图层控制、绘图、搜索等界面元素。该项目同时提供 MCP 服务,帮助编码 Agent 查询这些自定义元素的信息。
主要功能
- 01Web Component 形式的地理空间 UI 元素
- 02提供 eox-map、eox-drawtools 等组件
- 03支持通过 npm 或 script 标签引入
- 04MCP 服务提供自定义元素信息查询
适用场景
- 01在 Vite 或 Webpack 项目中构建地图界面
- 02编码 Agent 查询 EOxElements 组件的用法
- 03为 STAC 数据或时间序列添加界面控件
MCP 相关
该项目是 MCP 服务,向 MCP 客户端提供 EOxElements 自定义元素的相关信息,供编码 Agent 参考。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
服务地址
https://elements.mcp.eox.at一键复制安装命令
Claude CodeTerminal
claude mcp add --transport http eox-a-eoxelements https://elements.mcp.eox.atCursor.cursor/mcp.json
{"mcpServers":{"eox-a-eoxelements":{"type":"http","url":"https://elements.mcp.eox.at"}}}在 Cursor 中打开VS Code.vscode/mcp.json
{"servers":{"eox-a-eoxelements":{"type":"http","url":"https://elements.mcp.eox.at"}}}在 VS Code 中打开Claude Desktopclaude_desktop_config.json
{"mcpServers":{"eox-a-eoxelements":{"type":"http","url":"https://elements.mcp.eox.at"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"eox-a-eoxelements":{"serverUrl":"https://elements.mcp.eox.at"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
EOxElements
由 EOX 精心打造的地理空间 UI 元素 Web 组件集。
文档、示例
元素
- ⭕️ Alpha 元素仍在开发中,可能会频繁发生重大变更。
- 🟡 Beta 元素已基本完善,可供使用,但仍可能发生重大变更。
- ✅ Stable 元素经过审核、附有文档且 API 完整。
| 元素 | 描述 | 文档与示例 | 版本 | 状态 |
|---|---|---|---|---|
| eox-chart | 内置数据获取功能的动态图表 | 文档与示例 | ✅ | |
| eox-drawtools | 在地图上绘制和管理要素 | 文档与示例 | ✅ | |
| eox-feedback | 快速便捷的反馈组件 | 文档与示例 | ✅ | |
| eox-geosearch | 带自动补全功能的地理位置搜索输入框 | 文档与示例 | ✅ | |
| eox-itemfilter | 在客户端或服务端筛选/搜索大量条目 | 文档与示例 | ✅ | |
| eox-jsonform | 根据 JSON schema 渲染表单 | 文档与示例 | ✅ | |
| eox-layercontrol | 管理和修改地图图层 | 文档与示例 | ✅ | |
| eox-layout | 轻松创建 UI 布局 | 文档与示例 | ✅ | |
| eox-map | 配备强大工具和辅助功能的地图 | 文档与示例 | ✅ | |
| eox-stacinfo | 显示 STAC 文件的属性 | 文档与示例 | ✅ | |
| eox-storytelling | 基于 Markdown 的讲述工具 | 文档与示例 | ✅ | |
| eox-timecontrol | 控制和播放地图图层的时间 | 文档与示例 | ✅ | |
| eox-tour | 面向 UI 的引导式导览 | 文档与示例 | ✅ |
有关各个元素的详细说明和文档,请查看元素子文件夹中的 README。
打包工具(Vite、Webpack 等)
npm install @eox/<element>
import "@eox/<element>"
<eox-element></eox-element>
Script 标签
<eox-element></eox-element>
<script type="module">
import "@eox/<element>" from "https://cdn.skypack.dev/@eox/<element>"
</script>
开发
有关详细的开发说明,包括单体仓库结构、编码规范和测试流程,请参阅贡献指南。
在此仓库中工作的 AI Agent 还应查阅 AGENTS.md,了解维护文档并确保与 MCP 服务兼容的具体指南。
许可证
向 EOxElements 贡献内容,即表示您同意将您的贡献根据仓库的 LICENSE 进行许可。
以前的版本
此项目的 main 分支包含 EOxElements v2 版本。关于(旧版)EOxElements v1,请参阅 v1 分支。
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。