geopera-mcp 0.1.0__tar.gz

geopera_mcp-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,55 @@
+name: Publish MCP server (geopera-mcp)
+
+# Publishes geopera-mcp to PyPI on a tag like `v0.1.0`.
+# Uses PyPI Trusted Publishing (OIDC) — no stored token.
+#
+# One-time PyPI setup: pypi.org -> the geopera-mcp project -> Publishing -> add a GitHub
+# Actions publisher (repo geo-pera/geopera-mcp, workflow publish.yml, environment "pypi").
+# First publish uses PyPI's "pending publisher" flow.
+#
+# Release: bump `version` in pyproject.toml (and geopera_mcp/__init__.py), then:
+#   git tag vX.Y.Z && git push origin vX.Y.Z
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch: {}
+
+permissions:
+  contents: read
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write # OIDC token for PyPI Trusted Publishing
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Build sdist + wheel
+        run: |
+          python -m pip install --upgrade build twine
+          python -m build
+          twine check dist/*
+
+      - name: Sanity-check the wheel (console script + bundled snapshot)
+        run: |
+          python - <<'PY'
+          import glob, zipfile
+          whl = glob.glob("dist/*.whl")[0]
+          names = zipfile.ZipFile(whl).namelist()
+          assert any(n.endswith("geopera_mcp/kernel_openapi.json") for n in names), "snapshot not bundled in wheel"
+          entry = [n for n in names if n.endswith("entry_points.txt")]
+          txt = zipfile.ZipFile(whl).read(entry[0]).decode() if entry else ""
+          assert "geopera-mcp" in txt and "geopera_mcp.server:main" in txt, f"missing console script: {txt!r}"
+          print("ok: wheel bundles the snapshot and declares the `geopera-mcp` console script")
+          PY
+
+      - name: Publish to PyPI (Trusted Publishing)
+        uses: pypa/gh-action-pypi-publish@release/v1

geopera_mcp-0.1.0/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.venv/
+venv/
+.pytest_cache/
+.ruff_cache/

geopera_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Geopera
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

geopera_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.4
+Name: geopera-mcp
+Version: 0.1.0
+Summary: Model Context Protocol (MCP) server for the Geopera geospatial data platform
+Project-URL: Homepage, https://docs.geopera.com
+Project-URL: Documentation, https://docs.geopera.com/api-reference/sdks/mcp
+Project-URL: Source, https://github.com/geo-pera/geopera-mcp
+Author-email: Geopera <support@geopera.com>
+License: MIT
+License-File: LICENSE
+Keywords: ai-agents,claude,earth-observation,geopera,geospatial,mcp,model-context-protocol,satellite,stac
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: GIS
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Requires-Dist: fastmcp==3.4.2
+Requires-Dist: httpx==0.28.1
+Requires-Dist: mcp==1.27.2
+Requires-Dist: pydantic==2.13.4
+Requires-Dist: starlette==1.3.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# geopera-mcp
+
+The official [Model Context Protocol](https://modelcontextprotocol.io) server for the
+[Geopera](https://geopera.com) geospatial data platform. It exposes Geopera operations
+as MCP tools so an AI agent (Claude Desktop, Claude Code, or your own MCP client) can
+discover imagery, place and read back orders, run analytics, and more — with the same
+auth, scopes, and provenance as any other Geopera client.
+
+Each tool is named after its operation id (e.g. `orders.archive.place`) and proxies the
+call to `POST /v1/op/{operation_id}`. The server imports nothing from the backend; it is
+a standalone client of the same typed surface the Python/TypeScript SDKs and CLI consume.
+
+## Install
+
+```bash
+pip install geopera-mcp
+```
+
+This installs the `geopera-mcp` console command, which speaks the `stdio` transport that
+MCP clients attach to. Requires Python 3.11+.
+
+## Run
+
+The server is configured through environment variables. At minimum:
+
+```bash
+export GEOPERA_API_URL="https://api.geopera.com"
+export GEOPERA_API_TOKEN="gpra_..."   # a Geopera API key, or a session token
+geopera-mcp
+```
+
+`geopera-mcp` runs over stdio by default — your MCP client launches it as a subprocess.
+Set `MCP_TRANSPORT=http` to serve the streamable-HTTP transport instead (for a hosted
+deployment).
+
+## Wire it into an MCP client
+
+Add a `geopera` entry under `mcpServers`. For Claude Desktop
+(`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+```json
+{
+  "mcpServers": {
+    "geopera": {
+      "command": "geopera-mcp",
+      "env": {
+        "GEOPERA_API_URL": "https://api.geopera.com",
+        "GEOPERA_API_TOKEN": "gpra_your_api_key"
+      }
+    }
+  }
+}
+```
+
+Restart the client and the Geopera tools appear. The agent's reach is exactly the scopes
+on the token — it can do nothing the token could not do directly.
+
+## Environment variables
+
+| Variable | Purpose |
+| --- | --- |
+| `GEOPERA_API_URL` | Geopera API base URL. Default `https://api.geopera.com`. |
+| `GEOPERA_API_TOKEN` | A `gpra_` API key or a session token, sent upstream as `Authorization: Bearer`. |
+| `MCP_TRANSPORT` | `stdio` (default) or `http`. |
+| `PORT` | Port for the `http` transport. |
+
+## Documentation
+
+Full docs: [docs.geopera.com/api-reference/sdks/mcp](https://docs.geopera.com/api-reference/sdks/mcp).
+
+## License
+
+MIT

geopera_mcp-0.1.0/README.md

@@ -0,0 +1,73 @@
+# geopera-mcp
+
+The official [Model Context Protocol](https://modelcontextprotocol.io) server for the
+[Geopera](https://geopera.com) geospatial data platform. It exposes Geopera operations
+as MCP tools so an AI agent (Claude Desktop, Claude Code, or your own MCP client) can
+discover imagery, place and read back orders, run analytics, and more — with the same
+auth, scopes, and provenance as any other Geopera client.
+
+Each tool is named after its operation id (e.g. `orders.archive.place`) and proxies the
+call to `POST /v1/op/{operation_id}`. The server imports nothing from the backend; it is
+a standalone client of the same typed surface the Python/TypeScript SDKs and CLI consume.
+
+## Install
+
+```bash
+pip install geopera-mcp
+```
+
+This installs the `geopera-mcp` console command, which speaks the `stdio` transport that
+MCP clients attach to. Requires Python 3.11+.
+
+## Run
+
+The server is configured through environment variables. At minimum:
+
+```bash
+export GEOPERA_API_URL="https://api.geopera.com"
+export GEOPERA_API_TOKEN="gpra_..."   # a Geopera API key, or a session token
+geopera-mcp
+```
+
+`geopera-mcp` runs over stdio by default — your MCP client launches it as a subprocess.
+Set `MCP_TRANSPORT=http` to serve the streamable-HTTP transport instead (for a hosted
+deployment).
+
+## Wire it into an MCP client
+
+Add a `geopera` entry under `mcpServers`. For Claude Desktop
+(`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+```json
+{
+  "mcpServers": {
+    "geopera": {
+      "command": "geopera-mcp",
+      "env": {
+        "GEOPERA_API_URL": "https://api.geopera.com",
+        "GEOPERA_API_TOKEN": "gpra_your_api_key"
+      }
+    }
+  }
+}
+```
+
+Restart the client and the Geopera tools appear. The agent's reach is exactly the scopes
+on the token — it can do nothing the token could not do directly.
+
+## Environment variables
+
+| Variable | Purpose |
+| --- | --- |
+| `GEOPERA_API_URL` | Geopera API base URL. Default `https://api.geopera.com`. |
+| `GEOPERA_API_TOKEN` | A `gpra_` API key or a session token, sent upstream as `Authorization: Bearer`. |
+| `MCP_TRANSPORT` | `stdio` (default) or `http`. |
+| `PORT` | Port for the `http` transport. |
+
+## Documentation
+
+Full docs: [docs.geopera.com/api-reference/sdks/mcp](https://docs.geopera.com/api-reference/sdks/mcp).
+
+## License
+
+MIT

geopera_mcp-0.1.0/geopera_mcp/__init__.py

@@ -0,0 +1,13 @@
+"""geopera-mcp — Model Context Protocol server for the Geopera platform.
+
+Exposes Geopera operations as MCP tools so an AI agent (e.g. Claude) can discover
+imagery, place orders, read results back, and run analytics with the same auth,
+scopes, and provenance as any other client.
+
+Run the ``geopera-mcp`` console command over stdio (the default) and point your MCP
+client at it, or set ``MCP_TRANSPORT=http`` to serve the streamable-HTTP transport.
+Configuration is via environment variables — at minimum ``GEOPERA_API_URL`` and
+``GEOPERA_API_TOKEN`` (a ``gpra_`` API key or a session token).
+"""
+
+__version__ = "0.1.0"