Architecture: SDK

arch-sdk Doc

architecture active

Project

Architecture: SDK

Thin Python SDKs that prove external APIs work via pytest integration tests. Each SDK wraps a single external service's REST API with a typed client class.

Pattern

Language: Python 3.12+
Dependencies: requests only — no heavy frameworks
Build: hatchling
Lint: ruff
Tests: pytest (unit + integration against live API)
CI: Woodpecker on Forgejo
Registry: Forgejo PyPI

Structure

Instances

SDK	Service	Status
minio-sdk	MinIO S3	Complete (62/62 tests passing)
recraft-sdk	Recraft image generation	Planned

Relationship to MCP

SDKs are consumed by MCP servers. The SDK proves the API works; the MCP server wraps the SDK for Claude Code integration. SDK → MCP is always the dependency direction.