clio-kit 2.1.2__tar.gz → 2.2.0__tar.gz

{clio_kit-2.1.2 → clio_kit-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clio-kit
-Version: 2.1.2
+Version: 2.2.0
 Summary: CLIO Kit - MCP Servers, Clients, and Tools for AI Agents
 Project-URL: Homepage, https://github.com/iowarp/clio-kit
 Project-URL: Repository, https://github.com/iowarp/clio-kit

{clio_kit-2.1.2 → clio_kit-2.2.0}/clio-kit-mcp-servers/adios/server.json

@@ -2,16 +2,24 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.iowarp/adios-mcp",
   "title": "CLIO Adios",
-  "description": "Fetch and analyze BP5 data files using ADIOS2 for scientific data and metadata access.",
-  "version": "2.0.1",
-  "repository": {"url": "https://github.com/iowarp/clio-kit", "source": "github"},
+  "description": "Fetch and analyze BP5 data files using ADIOS2. Access scientific data, metadata, and attributes...",
+  "version": "2.2.0",
+  "repository": {
+    "url": "https://github.com/iowarp/clio-kit",
+    "source": "github"
+  },
   "packages": [
     {
       "registryType": "pypi",
       "identifier": "clio-kit",
-      "version": "2.0.1",
-      "transport": {"type": "stdio"},
-      "arguments": ["clio-kit", "adios"]
+      "version": "2.2.0",
+      "transport": {
+        "type": "stdio"
+      },
+      "arguments": [
+        "clio-kit",
+        "adios"
+      ]
     }
   ],
   "tools": [

{clio_kit-2.1.2 → clio_kit-2.2.0}/clio-kit-mcp-servers/arxiv/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.iowarp/arxiv-mcp",
   "title": "CLIO Arxiv",
   "description": "ArXiv MCP server implementation using Model Context Protocol",
-  "version": "2.0.1",
+  "version": "2.2.0",
   "repository": {
     "url": "https://github.com/iowarp/clio-kit",
     "source": "github"
@@ -12,7 +12,7 @@
     {
       "registryType": "pypi",
       "identifier": "clio-kit",
-      "version": "2.0.1",
+      "version": "2.2.0",
       "transport": {
         "type": "stdio"
       },

{clio_kit-2.1.2 → clio_kit-2.2.0}/clio-kit-mcp-servers/compression/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.iowarp/compression-mcp",
   "title": "CLIO Compression",
   "description": "Compression MCP server implementation using Model Context Protocol",
-  "version": "2.0.1",
+  "version": "2.2.0",
   "repository": {
     "url": "https://github.com/iowarp/clio-kit",
     "source": "github"
@@ -12,7 +12,7 @@
     {
       "registryType": "pypi",
       "identifier": "clio-kit",
-      "version": "2.0.1",
+      "version": "2.2.0",
       "transport": {
         "type": "stdio"
       },

{clio_kit-2.1.2 → clio_kit-2.2.0}/clio-kit-mcp-servers/darshan/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.iowarp/darshan-mcp",
   "title": "CLIO Darshan",
   "description": "Darshan I/O profiler MCP server for analyzing I/O trace files",
-  "version": "2.0.1",
+  "version": "2.2.0",
   "repository": {
     "url": "https://github.com/iowarp/clio-kit",
     "source": "github"
@@ -12,7 +12,7 @@
     {
       "registryType": "pypi",
       "identifier": "clio-kit",
-      "version": "2.0.1",
+      "version": "2.2.0",
       "transport": {
         "type": "stdio"
       },

clio_kit-2.2.0/clio-kit-mcp-servers/geo/.claude-plugin/plugin.json

@@ -0,0 +1,5 @@
+{
+  "name": "clio-geo",
+  "description": "MCP server for rendering GeoJSON vector layers into map images with basemaps",
+  "version": "1.0.1"
+}

clio_kit-2.2.0/clio-kit-mcp-servers/geo/.mcp.json

@@ -0,0 +1,9 @@
+{
+  "clio-geo": {
+    "command": "uvx",
+    "args": [
+      "clio-kit",
+      "geo"
+    ]
+  }
+}

clio_kit-2.2.0/clio-kit-mcp-servers/geo/README.md

@@ -0,0 +1,147 @@
+# Geo MCP
+
+Renders GeoJSON vector layers into map images. Any tool that returns GeoJSON
+features — catalog feature queries, file inspection, analysis output — can be
+visualized as a single layered map with an optional web-tile basemap.
+
+## Tool: `render_feature_map`
+
+Render one or more layers (polygons, lines, points) to a PNG.
+
+Each layer:
+
+```jsonc
+{
+  "name": "fire perimeter",
+  "geojson": { /* FeatureCollection | Feature | geometry | list | JSON string | path */ },
+  "style": {
+    "facecolor": "red", "edgecolor": "darkred", "alpha": 0.55, "linewidth": 2,
+    "color": "...",            // points / single-color fill
+    "markersize": 45,          // points
+    "zorder": 5,               // draw order
+    "color_by": "AQI",         // property to color by
+    "scale": "epa_aqi",        // EPA AQI bands, or a matplotlib colormap name
+    "category_colors": { "3 - 25": "#ccc" },  // explicit value -> color
+    "legend": true
+  }
+}
+```
+
+Top-level args: `output_path`, `title`, `basemap` (CartoDB Positron, needs
+network; degrades gracefully if tiles are unavailable), and an optional
+`bbox` view window `[min_lon, min_lat, max_lon, max_lat]`.
+
+Returns `{status, output_path, size_bytes, bounds, basemap, layers}`.
+
+### Example — wildfire downwind brief
+
+Three layers from live feature queries: a fire perimeter polygon (red), NWS
+smoke-forecast polygons colored by concentration class, and AirNow monitors
+colored by `epa_aqi`. One call produces the full situational map.
+
+## Run
+
+```sh
+uvx clio-kit geo          # via the clio-kit launcher
+geo-mcp                   # direct entry point
+```
+
+## Test
+
+```sh
+uv run --extra dev pytest
+```
+
+Tests disable the basemap so they run without network access.
+
+## Capabilities
+
+### `render_feature_map`
+**Description**: Render one or more GeoJSON layers (polygons/lines/points) onto a single map PNG with an optional basemap. Each layer accepts a style with fixed colors or data-driven coloring (color_by + category_colors, an 'epa_aqi' AQI scale, or a matplotlib colormap). Returns the output path and bounds.
+**Hints**: destructive, idempotent
+**Tags**: geojson, geospatial, map, visualization
+
+### `points_in_polygons`
+**Description**: Spatial overlap: return which GeoJSON points fall within (optionally buffered) GeoJSON polygons — e.g. which AirNow monitors lie inside the smoke footprint. Accepts inline GeoJSON or file paths. Returns the matched points with their properties and a matched_count.
+**Hints**: read-only, idempotent
+**Tags**: geojson, geospatial, overlap, spatial-join
+
+### `bounding_box`
+**Description**: Compute the bounding box [min_lon, min_lat, max_lon, max_lat] of GeoJSON features (inline or file path), optionally padded by buffer_km. A deterministic geometry op for deriving an analysis region from a fire perimeter.
+**Hints**: read-only, idempotent
+**Tags**: bbox, geojson, geospatial, region
+
+### `query_arcgis_features`
+**Description**: Query an ArcGIS FeatureServer layer (with optional lon/lat bbox and where clause) and write the returned features to a local GeoJSON file. The saved FeatureCollection can be fed directly into render_feature_map, points_in_polygons, or bounding_box.
+**Hints**: read-only, idempotent
+**Tags**: arcgis, features, geojson, geospatial, retrieval
+
+### `geocode`
+**Description**: Look up a free-text place name or location and return real coordinates from OpenStreetMap Nominatim (a lookup, not a model guess). Each match carries lat/lon, a [min_lon, min_lat, max_lon, max_lat] bbox, type, importance, and a provenance source so the region can be grounded and cited.
+**Hints**: read-only, idempotent
+**Tags**: coordinates, geocoding, location
+
+### `filter_points_by_radius`
+**Description**: Filter/rank any table of points by great-circle distance to a center. Reads a CSV (or GeoJSON points) of locations, computes the haversine distance from (center_lat, center_lon) to each row, and returns the rows within radius_km sorted ascending by distance, each annotated with distance_km. Latitude/longitude columns are auto-detected from common names (latitude/lat, longitude/lon/long) when not given. Domain-neutral: works for sensors, sites, cities, samples, or any lon/lat table.
+**Hints**: read-only, idempotent
+**Tags**: distance, filter, geospatial, haversine, proximity
+
+### Resources
+
+- `geo://capabilities` - Describe what the geo MCP server can do.
+
+### Prompts
+
+- **map_arcgis_layer**: Guided workflow: retrieve an ArcGIS layer and render it on a map.
+## Claude Code
+
+```bash
+claude mcp add clio-geo -- uvx clio-kit geo
+```
+
+Or install via the CLIO Kit plugin marketplace:
+
+```
+/plugin marketplace add iowarp/clio-kit
+/plugin install clio-geo@iowarp-clio-kit
+```
+## Claude Desktop
+
+Add to your Claude Desktop config (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "clio-geo": {
+      "command": "uvx",
+      "args": [
+        "clio-kit",
+        "geo"
+      ]
+    }
+  }
+}
+```
+## Gemini CLI
+
+Add to `~/.gemini/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "clio-geo": {
+      "command": "uvx",
+      "args": [
+        "clio-kit",
+        "geo"
+      ]
+    }
+  }
+}
+```
+
+Or install the CLIO Kit extension:
+
+```bash
+gemini extensions install https://github.com/iowarp/clio-kit
+```

clio_kit-2.2.0/clio-kit-mcp-servers/geo/pyproject.toml

@@ -0,0 +1,55 @@
+[project]
+name = "geo-mcp"
+version = "1.0.1"
+description = "MCP server for rendering GeoJSON vector layers into map images with basemaps"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "BSD-3-Clause"
+authors = [
+    { name = "IoWarp Team - Gnosis Research Center", email = "grc@illinoistech.edu" }
+]
+
+keywords = ["MCP", "geospatial", "mapping", "geojson", "visualization", "matplotlib", "geopandas"]
+
+dependencies = [
+    "fastmcp>=3.0.1",
+    "python-dotenv>=1.0.0",
+    "matplotlib>=3.6.0",
+    "geopandas>=0.14.0",
+    "shapely>=2.0.0",
+    "contextily>=1.5.0",
+    "numpy>=1.24.0",
+    "httpx>=0.27.0",
+]
+
+[project.urls]
+Homepage = "https://docs.iowarp.ai/"
+Repository = "https://github.com/iowarp/clio-kit"
+
+[project.scripts]
+geo-mcp = "geo_mcp.server:main"
+
+[dependency-groups]
+dev = [
+    "mypy>=1.17.0",
+    "pytest>=8.4.0",
+    "pytest-asyncio>=1.1.0",
+    "pytest-cov>=6.2.1",
+    "ruff>=0.12.5",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/geo_mcp"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]
+asyncio_mode = "auto"

clio_kit-2.2.0/clio-kit-mcp-servers/geo/server.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.iowarp/geo-mcp",
+  "title": "CLIO Geo",
+  "description": "MCP server for rendering GeoJSON vector layers into map images with basemaps",
+  "version": "2.2.0",
+  "repository": {
+    "url": "https://github.com/iowarp/clio-kit",
+    "source": "github"
+  },
+  "packages": [
+    {
+      "registryType": "pypi",
+      "identifier": "clio-kit",
+      "version": "2.2.0",
+      "transport": {
+        "type": "stdio"
+      },
+      "arguments": [
+        "clio-kit",
+        "geo"
+      ]
+    }
+  ],
+  "tools": [
+    {
+      "name": "render_feature_map",
+      "description": "Render one or more GeoJSON layers (polygons/lines/points) onto a single map PNG with an optional basemap. Each layer accepts a style with fixed colors or data-driven coloring (color_by + category_colors, an 'epa_aqi' AQI scale, or a matplotlib colormap). Returns the output path and bounds."
+    },
+    {
+      "name": "points_in_polygons",
+      "description": "Spatial overlap: return which GeoJSON points fall within (optionally buffered) GeoJSON polygons \u2014 e.g. which AirNow monitors lie inside the smoke footprint. Accepts inline GeoJSON or file paths. Returns the matched points with their properties and a matched_count."
+    },
+    {
+      "name": "bounding_box",
+      "description": "Compute the bounding box [min_lon, min_lat, max_lon, max_lat] of GeoJSON features (inline or file path), optionally padded by buffer_km. A deterministic geometry op for deriving an analysis region from a fire perimeter."
+    },
+    {
+      "name": "query_arcgis_features",
+      "description": "Query an ArcGIS FeatureServer layer (with optional lon/lat bbox and where clause) and write the returned features to a local GeoJSON file. The saved FeatureCollection can be fed directly into render_feature_map, points_in_polygons, or bounding_box."
+    },
+    {
+      "name": "geocode",
+      "description": "Look up a free-text place name or location and return real coordinates from OpenStreetMap Nominatim (a lookup, not a model guess). Each match carries lat/lon, a [min_lon, min_lat, max_lon, max_lat] bbox, type, importance, and a provenance source so the region can be grounded and cited."
+    },
+    {
+      "name": "filter_points_by_radius",
+      "description": "Filter/rank any table of points by great-circle distance to a center. Reads a CSV (or GeoJSON points) of locations, computes the haversine distance from (center_lat, center_lon) to each row, and returns the rows within radius_km sorted ascending by distance, each annotated with distance_km. Latitude/longitude columns are auto-detected from common names (latitude/lat, longitude/lon/long) when not given. Domain-neutral: works for sensors, sites, cities, samples, or any lon/lat table."
+    }
+  ],
+  "resources": [
+    {
+      "uri": "geo://capabilities",
+      "name": "capabilities",
+      "description": "Describe what the geo MCP server can do."
+    }
+  ],
+  "prompts": [
+    {
+      "name": "map_arcgis_layer",
+      "description": "Guided workflow: retrieve an ArcGIS layer and render it on a map."
+    }
+  ],
+  "tags": []
+}

clio_kit-2.2.0/clio-kit-mcp-servers/geo/src/geo_mcp/__init__.py

@@ -0,0 +1,5 @@
+"""Geo MCP server package."""
+
+from .server import main, mcp
+
+__all__ = ["main", "mcp"]

clio_kit-2.2.0/clio-kit-mcp-servers/geo/src/geo_mcp/implementation/__init__.py

@@ -0,0 +1,21 @@
+"""Implementation helpers for the geo MCP server."""
+
+from .arcgis import ArcGISQueryError, query_arcgis_features
+from .geocode import GeocodeError, geocode
+from .map_render import MapRenderError, render_map
+from .overlap import bounding_box, points_in_polygons
+from .proximity import ProximityError, filter_points_by_radius, haversine_km
+
+__all__ = [
+    "MapRenderError",
+    "render_map",
+    "points_in_polygons",
+    "bounding_box",
+    "ArcGISQueryError",
+    "query_arcgis_features",
+    "GeocodeError",
+    "geocode",
+    "ProximityError",
+    "filter_points_by_radius",
+    "haversine_km",
+]