README
🚀 Re:Earth CMS MCP 服务器
Re:Earth CMS MCP 服务器是 Re:Earth CMS 的 MCP 服务器,可助力用户高效管理资产、项目等内容。
🚀 快速开始
本 MCP 服务器为 Re:Earth CMS 提供支持,以下是一些实用的使用提示,帮助你快速上手:
| 使用场景 | 提示指令 |
|---------|--------|
| 添加评论 | 为项目 XXX 添加评论 "需要审核" |
| 批量更新 | 将 "locations" 模型中的所有项目状态更新为 "已发布" |
| 复制结构 | 复制 "template" 模型并命名为 "new-project" |
| 创建项目 | 在 "events" 模型中创建一个标题为 "Summer Festival" 且日期为 "2025-08-15" 的新项目 |
| 数据总结 | 总结 "sensors" 模型中的数据 |
| 探索模型 | 项目 XXX 中有哪些可用的模型? |
| 导出数据 | 将 "buildings" 模型中的所有项目导出为 GeoJSON 格式 |
| 列出所有项目 | 显示我工作区中的所有项目 |
| 发布资产 | 在项目 abc 中发布资产 123 |
| 发布项目 | 在 "articles" 模型中发布项目 456 |
| 搜索项目 | 查找 "products" 模型中包含 "Tokyo" 的所有项目 |
| 取消发布资产 | 在项目 abc 中取消发布资产 789 |
| 查看架构 | 显示 "articles" 模型的架构 |
✨ 主要特性
- 资产管理:管理资产并进行发布/取消发布操作
- 评论管理:对项目和资产添加、更新和删除评论
- 数据导出:将项目导出为 CSV 或 GeoJSON 格式
- 分组管理:创建、更新和删除分组
- 项目管理:创建、读取、更新、删除和发布项目
- 模型管理:列出模型并检索架构定义
- 项目管理:列出并管理工作区中的项目
请注意,此 MCP 不具备管理工作区、用户和模型架构的能力。
📦 安装指南
Docker(推荐)
docker pull reearth/reearth-cms-mcp
Go
go install github.com/reearth/reearth-cms-mcp
📚 详细文档
配置说明
前提条件
此 MCP 服务器使用 Re:Earth CMS 集成 API,因此你需要以下信息:
获取方法:
- 集成令牌:在你的 Re:Earth CMS 工作区设置中创建一个集成。(文档暂未提供)
- 工作区 ID:你可以在使用 Re:Earth CMS 编辑器时的 URL 中找到工作区 ID:
https://cms.reearth.io/workspaces/{workspace-id}/...
Claude 代码配置
| 安装方式 | 配置命令 |
| ---- | ---- |
| Docker(推荐) | bash<br>claude mcp add reearth-cms -e REEARTH_CMS_TOKEN=your-api-token -e REEARTH_CMS_WORKSPACE_ID=your-workspace-id -- docker run -i --rm -e REEARTH_CMS_TOKEN -e REEARTH_CMS_WORKSPACE_ID reearth/reearth-cms-mcp<br> |
| Go | bash<br>claude mcp add reearth-cms -e REEARTH_CMS_TOKEN=your-api-token -e REEARTH_CMS_WORKSPACE_ID=your-workspace-id -- reearth-cms-mcp<br> |
Claude 桌面端配置
将以下内容添加到你的 Claude 桌面端配置文件中:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
| 安装方式 | 配置内容 |
| ---- | ---- |
| Docker(推荐) | json<br>{<br> "mcpServers": {<br> "reearth-cms": {<br> "command": "docker",<br> "args": ["run", "-i", "--rm", "-e", "REEARTH_CMS_TOKEN", "-e", "REEARTH_CMS_WORKSPACE_ID", "reearth/reearth-cms-mcp"],<br> "env": {<br> "REEARTH_CMS_TOKEN": "your-api-token",<br> "REEARTH_CMS_WORKSPACE_ID": "your-workspace-id"<br> }<br> }<br> }<br>}<br> |
| Go | json<br>{<br> "mcpServers": {<br> "reearth-cms": {<br> "command": "reearth-cms-mcp",<br> "env": {<br> "REEARTH_CMS_TOKEN": "your-api-token",<br> "REEARTH_CMS_WORKSPACE_ID": "your-workspace-id"<br> }<br> }<br> }<br>}<br> |
Codex 配置
将以下内容添加到你的 Codex MCP 配置中:
| 安装方式 | 配置内容 |
| ---- | ---- |
| Docker(推荐) | toml<br>[mcp_servers.reearth-cms]<br>args = ["run", "-i", "--rm", "reearth/reearth-cms-mcp"]<br>command = "docker"<br><br>[mcp_servers.reearth-cms.env]<br>REEARTH_CMS_TOKEN = "you-api-token"<br>REEARTH_CMS_WORKSPACE_ID = "your-workspace-id"<br> |
| Go | toml<br>[mcp_servers.reearth-cms]<br>command = "reearth-cms-mcp"<br><br>[mcp_servers.reearth-cms.env]<br>REEARTH_CMS_TOKEN = "you-api-token"<br>REEARTH_CMS_WORKSPACE_ID = "your-workspace-id"<br> |
Cursor 配置
将以下内容添加到你的 Cursor MCP 配置文件(~/.cursor/mcp.json)中:
| 安装方式 | 配置内容 |
| ---- | ---- |
| Docker(推荐) | json<br>{<br> "mcpServers": {<br> "reearth-cms": {<br> "command": "docker",<br> "args": ["run", "-i", "--rm", "-e", "REEARTH_CMS_TOKEN", "-e", "REEARTH_CMS_WORKSPACE_ID", "reearth/reearth-cms-mcp"],<br> "env": {<br> "REEARTH_CMS_TOKEN": "your-api-token",<br> "REEARTH_CMS_WORKSPACE_ID": "your-workspace-id"<br> }<br> }<br> }<br>}<br> |
| Go | json<br>{<br> "mcpServers": {<br> "reearth-cms": {<br> "command": "reearth-cms-mcp",<br> "env": {<br> "REEARTH_CMS_TOKEN": "your-api-token",<br> "REEARTH_CMS_WORKSPACE_ID": "your-workspace-id"<br> }<br> }<br> }<br>}<br> |
Raycast 配置
| 安装方式 | 配置步骤 |
| ---- | ---- |
| Docker(推荐) | 1. 打开 Raycast 设置
2. 转到 扩展 > AI 命令 > MCP 服务器
3. 点击 添加服务器 并进行配置:
| Field | Value |
|-------|-------|
| Name | reearth-cms |
| Command | docker |
| Arguments | run -i --rm -e REEARTH_CMS_TOKEN -e REEARTH_CMS_WORKSPACE_ID reearth/reearth-cms-mcp |
4. 添加环境变量:
| Variable | Value |
|----------|-------|
| REEARTH_CMS_TOKEN | your-api-token |
| REEARTH_CMS_WORKSPACE_ID | your-workspace-id |
或者通过配置文件(~/.config/raycast/mcp.json):json<br>{<br> "mcpServers": {<br> "reearth-cms": {<br> "command": "docker",<br> "args": ["run", "-i", "--rm", "-e", "REEARTH_CMS_TOKEN", "-e", "REEARTH_CMS_WORKSPACE_ID", "reearth/reearth-cms-mcp"],<br> "env": {<br> "REEARTH_CMS_TOKEN": "your-api-token",<br> "REEARTH_CMS_WORKSPACE_ID": "your-workspace-id"<br> }<br> }<br> }<br>}<br> |
| Go | 1. 打开 Raycast 设置
2. 转到 扩展 > AI 命令 > MCP 服务器
3. 点击 添加服务器 并进行配置:
| Field | Value |
|-------|-------|
| Name | reearth-cms |
| Command | reearth-cms-mcp |
4. 添加环境变量:
| Variable | Value |
|----------|-------|
| REEARTH_CMS_TOKEN | your-api-token |
| REEARTH_CMS_WORKSPACE_ID | your-workspace-id |
或者通过 Raycast 的配置文件(~/.config/raycast/mcp.json)添加服务器:json<br>{<br> "mcpServers": {<br> "reearth-cms": {<br> "command": "reearth-cms-mcp",<br> "env": {<br> "REEARTH_CMS_TOKEN": "your-api-token",<br> "REEARTH_CMS_WORKSPACE_ID": "your-workspace-id"<br> }<br> }<br> }<br>}<br> |
VS Code 配置
| 安装方式 | 配置内容 |
| ---- | ---- |
| Docker(推荐) | json<br>{<br> "mcp": {<br> "servers": {<br> "reearth-cms": {<br> "command": "docker",<br> "args": ["run", "-i", "--rm", "-e", "REEARTH_CMS_TOKEN", "-e", "REEARTH_CMS_WORKSPACE_ID", "reearth/reearth-cms-mcp"],<br> "env": {<br> "REEARTH_CMS_TOKEN": "your-api-token",<br> "REEARTH_CMS_WORKSPACE_ID": "your-workspace-id"<br> }<br> }<br> }<br> }<br>}<br> |
| Go | json<br>{<br> "mcp": {<br> "servers": {<br> "reearth-cms": {<br> "command": "reearth-cms-mcp",<br> "env": {<br> "REEARTH_CMS_TOKEN": "your-api-token",<br> "REEARTH_CMS_WORKSPACE_ID": "your-workspace-id"<br> }<br> }<br> }<br> }<br>}<br> |
📄 许可证
本项目采用 Apache 许可证 2.0。有关详细信息,请参阅 LICENSE 文件。
微信扫一扫