eo-processor-mcp

Coverage

An MCP (Model Context Protocol) server for Earth Observation processing, powered by eo-processor.

Similar to stac-mcp for STAC catalog operations, this server exposes eo-processor's high-performance Rust-accelerated EO computation functions as MCP tools that AI agents can invoke.

Features

  • 15 MCP tools covering spectral indices, change detection, temporal statistics, masking, morphology, distances, trend analysis, classification, texture features, zonal statistics, and more
  • Rust-accelerated computation via eo-processor's PyO3 bindings (GIL-released, multi-core parallel)
  • stdio and HTTP transport support
  • Observability built in (structured logging, metrics, correlation IDs, latency histograms)
  • Prompts to guide AI agents in using the tools effectively

Tools

Tool Description
compute_spectral_index Compute spectral indices (NDVI, NDWI, EVI, SAVI, etc.) from band .npy files
compute_change_index Change detection (delta_ndvi, delta_nbr, dnbr, rbr) from pre/post imagery
temporal_statistics Median, mean, std, sum along the time axis
temporal_composite Weighted temporal composite of 4D arrays
moving_average Moving average with optional stride/downsampling
apply_mask Unified masking (by values, range, SCL, NaN replacement)
morphological_operation Binary dilation, erosion, opening, closing
compute_distances Pairwise distances (euclidean, manhattan, chebyshev, minkowski)
analyze_trends Linear regression and trend analysis with break detection
bfast_monitor BFAST Monitor change detection on time series
classify Random Forest train/predict, complex multi-band classification
texture_features Haralick/GLCM texture features
zonal_statistics Zonal statistics (count, sum, mean, min, max, std per zone)
pixelwise_transform Linear transform with optional clamping
list_capabilities List all available indices, operations, and tools

Installation

pip install -e .
# or with uv
uv pip install -e .

Usage

stdio (default)

eo-processor-mcp
# or
python -m eo_processor_mcp

HTTP/SSE

EO_PROCESSOR_MCP_TRANSPORT=http python -m eo_processor_mcp

MCP Client Configuration

{
  "eo-processor": {
    "command": "uvx",
    "args": ["--from", "git+https://github.com/BnJam/eo-processor-mcp", "eo-processor-mcp"],
    "transport": "stdio"
  }
}

Data Format

All tools accept NumPy .npy file paths as input and write results to .npy files. Tool responses include:

  • output_path: Path to the result .npy file
  • stats: Summary statistics (shape, dtype, min, max, mean, std, NaN count)

Environment Variables

Variable Default Purpose
EO_PROCESSOR_MCP_TRANSPORT stdio Transport mode (stdio, http, streamable-http, sse)
EO_PROCESSOR_MCP_HOST 127.0.0.1 HTTP host
EO_PROCESSOR_MCP_PORT 8000 HTTP port
EO_PROCESSOR_MCP_LOG_LEVEL WARNING Logging level
EO_PROCESSOR_MCP_LOG_FORMAT text Log format (text or json)
EO_PROCESSOR_MCP_ENABLE_METRICS true Enable in-process metrics
EO_PROCESSOR_MCP_ENABLE_TRACE false Enable trace span logging

Development

make install-dev    # Install with dev dependencies
make test           # Run tests
make lint           # Run ruff
make format         # Auto-format
make coverage       # Coverage report

License

Apache-2.0

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for bnjam from gravatar.com bnjam

Credits

Author: BnJam

License

Apache Software License (Apache-2.0)

Requires

Python >=3.11

Provides Extra

dev

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

eo_processor_mcp-0.1.1.tar.gz (23.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

eo_processor_mcp-0.1.1-py3-none-any.whl (32.4 kB view details)

Uploaded Python 3

File details

Details for the file eo_processor_mcp-0.1.1.tar.gz.

File metadata

  • Download URL: eo_processor_mcp-0.1.1.tar.gz
  • Upload date:
  • Size: 23.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for eo_processor_mcp-0.1.1.tar.gz
Algorithm Hash digest
SHA256 7eb9eede0b94d9dce3e22d7cbcf3c8157da83eba42c3144e1735da81cb5636c2
MD5 b56a995736f9aafdb526006412426d15
BLAKE2b-256 f16afe91ff8489f3e70304952d6c3e34ba333e524f3959bd27654545ca85bb5c

See more details on using hashes here.

Provenance

The following attestation bundles were made for eo_processor_mcp-0.1.1.tar.gz:

Publisher: container.yml on BnJam/eo-processor-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file eo_processor_mcp-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for eo_processor_mcp-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 ffc7e8cefa4acbbd9b5520cc72d9f92f135e12e1a7ac3c768824db7280be987f
MD5 b39a7891f858ecdbc26fbe0b10874e2d
BLAKE2b-256 7152d3b136f161362fd3727dfe66ce82a02718e34662c0296569836a0a0d49c5

See more details on using hashes here.

Provenance

The following attestation bundles were made for eo_processor_mcp-0.1.1-py3-none-any.whl:

Publisher: container.yml on BnJam/eo-processor-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page