https://github.com/reearth/reearth-cms-mcp
MCP server for Re:Earth CMS
https://github.com/reearth/reearth-cms-mcp
cms golang mcp mcp-server reearth
Last synced: 4 months ago
JSON representation
MCP server for Re:Earth CMS
- Host: GitHub
- URL: https://github.com/reearth/reearth-cms-mcp
- Owner: reearth
- License: apache-2.0
- Created: 2025-12-10T08:00:48.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-12-10T12:15:59.000Z (7 months ago)
- Last Synced: 2025-12-10T16:37:36.561Z (7 months ago)
- Topics: cms, golang, mcp, mcp-server, reearth
- Language: Go
- Homepage: https://cms.reearth.io
- Size: 61.5 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Re:Earth CMS MCP Server
> MCP server for [Re:Earth CMS](https://reearth.io/product/cms).
## Usecases
Here are some useful prompts to get started:
| Usecase | Prompt |
|---------|--------|
| Add comment | `Add a comment "Needs review" to item XXX` |
| Bulk update | `Update all items in "locations" model to set status to "published"` |
| Copy structure | `Copy the "template" model and name it "new-project"` |
| Create item | `Create a new item in the "events" model with title "Summer Festival" and date "2025-08-15"` |
| Data summary | `Summarize the data in the "sensors" model` |
| Explore models | `What models are available in project XXX?` |
| Export data | `Export all items from "buildings" model as GeoJSON` |
| List all projects | `Show me all projects in my workspace` |
| Publish asset | `Publish asset 123 in project abc` |
| Publish item | `Publish item 456 in model "articles"` |
| Search items | `Find all items in the "products" model that contain "Tokyo"` |
| Unpublish asset | `Unpublish asset 789 in project abc` |
| View schema | `Show me the schema for the "articles" model` |
## Features
- **Assets**: Manage assets and publish/unpublish them
- **Comments**: Add, update, and delete comments on items and assets
- **Export**: Export items as CSV or GeoJSON
- **Groups**: Create, update, and delete groups
- **Items**: Create, read, update, delete, and publish items
- **Models**: List models and retrieve schema definitions
- **Projects**: List and manage projects in your workspace
Note that this MCP doesn't have capabilities to manage workspaces, users and model's schemas.
## Installation
### Docker (Recommended)
```bash
docker pull reearth/reearth-cms-mcp
```
### Go
```bash
go install github.com/reearth/reearth-cms-mcp
```
## Configuration
### Prerequisites
This MCP server uses the Re:Earth CMS integration API, so you need the following information:
**How to obtain:**
- **Integration Token**: Create an integration in your Re:Earth CMS workspace settings. (Documentation is not yet available)
- **Workspace ID**: You can find your workspace ID in the URL when using Re:Earth CMS editor: `https://cms.reearth.io/workspaces/{workspace-id}/...`
Claude Code
Docker (Recommended)Go
```bash
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
```
```bash
claude mcp add reearth-cms -e REEARTH_CMS_TOKEN=your-api-token -e REEARTH_CMS_WORKSPACE_ID=your-workspace-id -- reearth-cms-mcp
```
Claude Desktop
Add the following to your Claude Desktop config file:
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
Docker (Recommended)Go
```json
{
"mcpServers": {
"reearth-cms": {
"command": "docker",
"args": ["run", "-i", "--rm", "-e", "REEARTH_CMS_TOKEN", "-e", "REEARTH_CMS_WORKSPACE_ID", "reearth/reearth-cms-mcp"],
"env": {
"REEARTH_CMS_TOKEN": "your-api-token",
"REEARTH_CMS_WORKSPACE_ID": "your-workspace-id"
}
}
}
}
```
```json
{
"mcpServers": {
"reearth-cms": {
"command": "reearth-cms-mcp",
"env": {
"REEARTH_CMS_TOKEN": "your-api-token",
"REEARTH_CMS_WORKSPACE_ID": "your-workspace-id"
}
}
}
}
```
Codex
Add the following to your Codex MCP configuration:
Docker (Recommended)Go
```toml
[mcp_servers.reearth-cms]
args = ["run", "-i", "--rm", "reearth/reearth-cms-mcp"]
command = "docker"
[mcp_servers.reearth-cms.env]
REEARTH_CMS_TOKEN = "you-api-token"
REEARTH_CMS_WORKSPACE_ID = "your-workspace-id"
```
```toml
[mcp_servers.reearth-cms]
command = "reearth-cms-mcp"
[mcp_servers.reearth-cms.env]
REEARTH_CMS_TOKEN = "you-api-token"
REEARTH_CMS_WORKSPACE_ID = "your-workspace-id"
```
Cursor
Add the following to your Cursor MCP configuration (`~/.cursor/mcp.json`):
Docker (Recommended)Go
```json
{
"mcpServers": {
"reearth-cms": {
"command": "docker",
"args": ["run", "-i", "--rm", "-e", "REEARTH_CMS_TOKEN", "-e", "REEARTH_CMS_WORKSPACE_ID", "reearth/reearth-cms-mcp"],
"env": {
"REEARTH_CMS_TOKEN": "your-api-token",
"REEARTH_CMS_WORKSPACE_ID": "your-workspace-id"
}
}
}
}
```
```json
{
"mcpServers": {
"reearth-cms": {
"command": "reearth-cms-mcp",
"env": {
"REEARTH_CMS_TOKEN": "your-api-token",
"REEARTH_CMS_WORKSPACE_ID": "your-workspace-id"
}
}
}
}
```
Raycast
Docker (Recommended)Go
1. Open Raycast Settings
2. Go to **Extensions** > **AI Commands** > **MCP Servers**
3. Click **Add Server** and configure:
| 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. Add environment variables:
| Variable | Value |
|----------|-------|
| `REEARTH_CMS_TOKEN` | `your-api-token` |
| `REEARTH_CMS_WORKSPACE_ID` | `your-workspace-id` |
Or via config file (`~/.config/raycast/mcp.json`):
```json
{
"mcpServers": {
"reearth-cms": {
"command": "docker",
"args": ["run", "-i", "--rm", "-e", "REEARTH_CMS_TOKEN", "-e", "REEARTH_CMS_WORKSPACE_ID", "reearth/reearth-cms-mcp"],
"env": {
"REEARTH_CMS_TOKEN": "your-api-token",
"REEARTH_CMS_WORKSPACE_ID": "your-workspace-id"
}
}
}
}
```
1. Open Raycast Settings
2. Go to **Extensions** > **AI Commands** > **MCP Servers**
3. Click **Add Server** and configure:
| Field | Value |
|-------|-------|
| Name | `reearth-cms` |
| Command | `reearth-cms-mcp` |
4. Add environment variables:
| Variable | Value |
|----------|-------|
| `REEARTH_CMS_TOKEN` | `your-api-token` |
| `REEARTH_CMS_WORKSPACE_ID` | `your-workspace-id` |
Alternatively, you can add the server via Raycast's config file (`~/.config/raycast/mcp.json`):
```json
{
"mcpServers": {
"reearth-cms": {
"command": "reearth-cms-mcp",
"env": {
"REEARTH_CMS_TOKEN": "your-api-token",
"REEARTH_CMS_WORKSPACE_ID": "your-workspace-id"
}
}
}
}
```
VS Code
Docker (Recommended)Go
VS Code (version 1.101 or greater)
```json
{
"mcp": {
"servers": {
"reearth-cms": {
"command": "docker",
"args": ["run", "-i", "--rm", "-e", "REEARTH_CMS_TOKEN", "-e", "REEARTH_CMS_WORKSPACE_ID", "reearth/reearth-cms-mcp"],
"env": {
"REEARTH_CMS_TOKEN": "your-api-token",
"REEARTH_CMS_WORKSPACE_ID": "your-workspace-id"
}
}
}
}
}
```
```json
{
"mcp": {
"servers": {
"reearth-cms": {
"command": "reearth-cms-mcp",
"env": {
"REEARTH_CMS_TOKEN": "your-api-token",
"REEARTH_CMS_WORKSPACE_ID": "your-workspace-id"
}
}
}
}
}
```
## License
This project is licensed under the Apache License 2.0. See the [LICENSE](./LICENSE) file for details.