nc-mcp

# NetCDF Explorer MCP Server A simple and powerful MCP (Message Communication Protocol) server for exploring, analyzing, and interacting with NetCDF format files. Designed to simplify NetCDF data management with intuitive APIs and efficient data handling. ## Overview NetCDF (Network Common Data Form) is a widely used format for storing scientific data. This MCP server provides a streamlined interface to work with NetCDF files, offering essential functionalities to list files, inspect structures, extract data, and analyze variables—all while handling large datasets efficiently through smart sampling. ## Features - 📁 **File Discovery**: List all NetCDF files (`.nc`, `.cdf`, `.netcdf`, `.nc4`) in a specified directory. - 🔍 **Structure Inspection**: Retrieve detailed metadata of NetCDF files, including dimensions, variables, attributes, and global properties. - 📊 **Data Extraction**: Read variable data with support for flexible slicing (e.g., `lat: "0:10:2"` to extract subsets). - 🧠 **Smart Sampling**: Automatically sample large datasets to prevent memory overflow, with configurable element limits. - ⏰ **Time Series Analysis**: Extract temporal data from spatial variables, with optional custom location coordinates. - 🔎 **Search Functionality**: Find variables and attributes by keyword, simplifying navigation in complex files. - 📋 **Variable Summaries**: Generate human-readable summaries of variables, including dimensions, data types, and attributes. ## Installation ### Prerequisites - Python ≥ 3.13 ### Install via pip ```bash pip install nc-mcp ``` ### Install from Source 1. Clone the repository: ```bash git clone https://github.com/HanchaoLi/nc-mcp.git cd nc-mcp ``` 2. Install dependencies (using `uv` for faster dependency management): ```bash # Install uv (if not already installed) curl -LsSf https://astral.sh/uv/install.sh | sh # Sync dependencies uv sync --all-groups ``` ## Quick Start ### Start the Server ```bash py…