Skip to content

docs #3

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Apr 3, 2025
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 15 additions & 30 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,8 @@

Earthdata MCP Server is a [Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) server implementation that provides tools to interact with [NASA Earth Data](https://www.earthdata.nasa.gov/). It enables efficient dataset discovery and retrieval for Geospatial analysis.

The following demo uses this MCP server to search for datasets and data granules on NASA Earthdata and the [jupyter-mcp-server](https://github.com/datalayer/jupyter-mcp-server) to run the analysis in JupyterLab.

<div>
<a href="https://www.loom.com/share/c2b5b05f548d4f1492d5c107f0c48dbc">
<p>Analyzing Sea Level Rise with AI-Powered Geospatial Tools and Jupyter - Watch Video</p>
Expand All @@ -24,19 +26,6 @@ Earthdata MCP Server is a [Model Context Protocol](https://modelcontextprotocol.
</a>
</div>

## Docker Image

```bash
# or run `docker build -t datalayer/earthdata-mcp-server .`
make build-docker
```

If you prefer, you can pull the prebuilt images.

```bash
make pull-docker
```

## Use with Claude Desktop

To use this with Claude Desktop, add the following to your `claude_desktop_config.json`.
Expand All @@ -57,29 +46,12 @@ To use this with Claude Desktop, add the following to your `claude_desktop_confi
}
```

> IMPORTANT
>
> You will also need the Jupyter MCP Server as documented on https://github.com/datalayer/jupyter-mcp-server.

If you are using Linux, start Claude with the following command.

```bash
make claude-linux
```

Start JupyterLab.

```bash
make jupyterlab
```

You can now prompt via Claude.

```
create an analysis about sea level rise from 2000 to 2025 in my jupyter notebook with real downloaded data
before that, install the needed python libraries you will need for the analysis
```

## Tools

The server offers 2 tools.
Expand All @@ -103,3 +75,16 @@ The server offers 2 tools.
- temporal (tuple): (Optional) Temporal range in the format (date_from, date_to).
- bounding_box (tuple): (Optional) Bounding box in the format (lower_left_lon, lower_left_lat, upper_right_lon, upper_right_lat).
- Returns: List of data granules.

## Building

```bash
# or run `docker build -t datalayer/earthdata-mcp-server .`
make build-docker
```

If you prefer, you can pull the prebuilt images.

```bash
make pull-docker
```