Skip to main content
Glama
erddap-mcp-demo

erddap-mcp-demo

by srstsavage

ERDDAP MCP demo

Demo implementation of a Model Context Protocol server allowing an LLM to interact with ERDDAP search, metadata, and tabledap services.

Example usage

Usage

Make sure you have uv installed, then add the MCP server to the desired MCP capable client.

Related MCP server: Oceanum MCP

Example for Claude Desktop

NOTE: claude.ai is not MCP capable at the time of writing

Add the erddap_mcp_demo.py tool to the Clade config file at:

  • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Linux: ~/.config//Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "erddap-tabledap": {
      "command": "/path/to/uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/path/to/erddap_mcp_demo.py"
      ]
    }
  }
}

Then start/restart Claude desktop and ask it to get some data!

See https://modelcontextprotocol.io/quickstart/user

Testing

uv run mcp dev erddap_mcp_demo.py

Available Tools

5 tools
get_dataset_variable_dataC

Get data for a variable in a dataset served by an ERDDAP server. Time is always included in the results.

Inputs: dataset_id (required), erddap_url (required), start_time (required), variable_name (required), +2 more.

get_variable_standard_namesA

List all variable parameter CF standard names in datasets served by this ERDDAP server.

These variable parameter standard names can be used when searching an ERDDAP for datasets containing variables measuring specific parameters. If we are looking for datasets with variables measuring a specific property, we should retrieve this list first and then use a discovered standard name value when searching the ERDDAP server.

Inputs: erddap_url (required).

list_datasetsC

List all datasets in an ERDDAP server

Inputs: erddap_url (required).

list_dataset_variablesC

List all variables for a dataset in an ERDDAP server

Inputs: dataset_id (required), erddap_url (required).

search_datasetsC

List all datasets in an ERDDAP server

Inputs: erddap_url (required), page, max_time, min_time, +7 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.6/5.0

    Scored across 5 tools

    Disambiguation2/5

    There is significant overlap: 'list_datasets' and 'search_datasets' have identical descriptions and appear to serve the same purpose, making it hard for an agent to distinguish them. Other tools are distinct but the duplication is a major issue.

    Naming Consistency3/5

    Names follow a verb_noun pattern with underscores, but there is inconsistency in verb choice: 'list_datasets' vs 'search_datasets' for the same action, and 'get_' vs 'list_' across similar operations. While readable, the pattern is not fully consistent.

    Tool Count4/5

    5 tools is within the well-scoped range for an ERDDAP server. However, the duplication reduces effective distinct tools to 4, making the count slightly less efficient but still acceptable.

    Completeness3/5

    The set covers listing datasets, listing variables, and retrieving data, but lacks tools for dataset metadata (e.g., attributes, time ranges) or data export formats. Basic querying is possible, but notable gaps exist.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Access oceanographic and environmental data from 63+ ERDDAP servers worldwide through natural language queries. Search datasets, retrieve metadata, and download scientific data for climate research, marine biology, and coastal management.
      18
      -
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to search, query, and manage ocean/environmental datasets from the Oceanum platform, and to read, write, and delete files in Oceanum cloud storage.
      13
      1
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables LLMs to work with Copernicus Marine ocean data through semantic tools for dataset discovery, metadata retrieval, recommendation, validation, point time-series extraction, area statistics, subsetting, and computation without exposing raw API plumbing.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables search and live data access to US IOOS regional ocean observing ERDDAP servers, covering buoys, tide gauges, gliders, HF radar currents, water quality, and regional model grids via tools for dataset discovery, metadata, and time-series or gridded point extraction.
      109 npm
      MIT