Skip to content

Add Zedcloud Python SDK, automation framework, and MCP server - #1

Merged
vignesh-zededa merged 2 commits into
mainfrom
cursor/zedcloud-python-sdk-5998
Sep 30, 2026
Merged

vignesh-zededa merged 2 commits into
mainfrom
cursor/zedcloud-python-sdk-5998

Conversation

@vignesh-zededa

@vignesh-zededa vignesh-zededa commented Sep 25, 2026 •

Copy link
Copy Markdown
Owner

Summary

Production-quality Python monorepo for ZEDEDA Zedcloud APIs:

  • zedcloud — typed sync SDK (httpx + Pydantic v2) with service namespaces (apps, nodes, networks, iam, k8s, storage, jobs, …)
  • zedcloud-automation — pytest fixtures/markers + read-only smoke tests (skip without credentials)
  • zedcloud-mcp — stdio MCP server (mcp 2.x MCPServer) with 16 focused tools
  • Committed OpenAPI 2.0 specs under openapi/ + scripts/generate_from_openapi.py codegen pipeline
  • uv workspace, MIT license, CI (ruff + mocked unit tests on 3.10/3.12)

Auth

  • ZEDCLOUD_BASE_URL + ZEDCLOUD_TOKEN (Bearer)
  • Kubernetes/ZKS also sends X-API-KEY (optional ZEDCLOUD_API_KEY, defaults to token)

Verification

  • uv sync --all-packages --group dev
  • make generate (idempotent; CI checks clean tree)
  • uv run pytest -q -m "not needs_cloud" → 8 passed
  • MCP list_tools → 16 tools
  • Live smoke tests skip cleanly without credentials

Notes

  • Generated models expose OpenAPI field list as list_ (Pydantic reserved-name handling)
  • Codegen sanitizes broken UUID regexes and conflicting type+$ref swagger quirks before datamodel-code-generator
Open in Web Open in Cursor 

cursoragent and others added 2 commits September 25, 2026 05:39
Introduce a uv/hatchling workspace with:
- zedcloud: typed httpx + Pydantic v2 client generated from committed
  OpenAPI swagger specs (11 services), with retries, ApiError types,
  Bearer + X-API-KEY auth, and pagination helpers
- zedcloud-automation: pytest fixtures, markers, and read-only smoke tests
- zedcloud-mcp: stdio MCP server exposing focused nodes/apps/networks/k8s/jobs tools
- codegen script, Makefile, CI (ruff + mocked tests), MIT license, docs

Co-authored-by: vignesh-zededa <vignesh-zededa@users.noreply.github.com>
Remove shared tests/__init__.py packages that collided across members
and use --import-mode=importlib for the monorepo.

Co-authored-by: vignesh-zededa <vignesh-zededa@users.noreply.github.com>
@vignesh-zededa
vignesh-zededa merged commit 6553f67 into main Sep 30, 2026
0 of 2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants