mzizi-mcp

Model Context Protocol server for the Mzizi component registry.

Reads the document-route store on Supabase — one self-contained JSON document per component, keyed by node collection (n1_tokens … n10_documentation). One fetch, no joins.

This is the new-tooling tier of the Mzizi/Bundu/Nyuchi MCP stack. The legacy relational MCP lives on the legacy branch of nyuchi/mzizi and is served at design.nyuchi.com/mcp. This server is the going-forward implementation.

Distribution

Three transports, one server factory:

| Surface | Entry | Use | | ----------------- | ---------------- | ------------------------------------------------ | | stdio | npx mzizi-mcp | Local AI assistants (Claude Code, Cursor, etc.) | | HTTP / Worker | mzizi-mcp/http | Cloudflare Workers + Next.js + any fetch-runtime | | Library | mzizi-mcp | Embed the server factory in your own host |

Tools

All reads go through the canonical document-API RPCs on nyuchi_design_db; this server never touches the legacy schema.

| Tool | Backed by | Returns | | --------------------- | -------------------------------------------------- | --------------------------------------------------------------- | | list_collections | direct component_documents aggregate | Every collection + document counts + per-owner breakdown | | read_documents | read_documents(collection, name?, owner?, …) RPC | Generic collection reader; one document if name is given | | get_component | read_documents('components', name, …) RPC | Full component document (metadata, sources, files, source code) | | list_components | read_documents('components', …) RPC | Lean index, optional owner filter | | get_node_documents | get_node_documents(node, collection?, …) RPC | All documents for an ecosystem node (1–10), optional collection | | read_versions | read_versions(collection, name, limit?) RPC | Version-history snapshots for a document | | get_database_status | direct component_documents count | Provider health + document-store row count |

Resources

| URI | Content | | --------------------- | ---------------------------------------------------- | | mzizi://collections | Every collection + document counts + owner breakdown | | mzizi://components | Lean index of the components collection |

Configuration

The server is read-only and uses the Supabase anon role under RLS. Set:

SUPABASE_URL              # or NEXT_PUBLIC_SUPABASE_URL
SUPABASE_PUBLISHABLE_KEY  # or NEXT_PUBLIC_SUPABASE_ANON_KEY

The HTTP handler accepts an optional WithSupabaseConfig override.

License

Apache-2.0.