wazobiatech-nexus-mcp 1.1.0

Python SDK for Nexus MCP

wazobiatech-nexus-mcp

Python SDK for the Nexus MCP ecosystem. Provides HMAC signing/verification and MCP server scaffolding.

Installation

pip install wazobiatech-nexus-mcp==1.1.0

Usage

HMAC Signing

from nexus_mcp.hmac_utils import sign_request

sig, ts = sign_request("GET", "/mcp/manifest", "my-secret")
print("x-signature:", sig)
print("x-timestamp:", ts)

HMAC Middleware (FastAPI)

from fastapi import FastAPI
from nexus_mcp.middleware import HMACMiddleware

app = FastAPI()
app.add_middleware(HMACMiddleware, hmac_secret="my-secret")

MCP Server

from nexus_mcp.server import create_mcp_server
from nexus_mcp.models import Manifest

app = create_mcp_server(
    port=8000,
    hmac_secret="my-secret",
    manifest=Manifest(...),
    tools=[...],
)

# Start with uvicorn
# uvicorn.run(app, host="0.0.0.0", port=8000)

Testing

poetry install
poetry run pytest

Contract vector tests verify every entry from nexus-mcp-contract/vectors.json.

Tool Naming Convention

Tool names follow the Wazobia inter-service MCP convention:

Pattern	Valid?	Example
service__tool_name	✅	thoth__process_content, krisis__score_article
plain_snake_case	✅	health_check, process_content

Names start with a lowercase letter and contain only [a-z0-9_]. The double underscore __ is exactly two — not one (which would be part of the slug) and not three or more (which is invalid). Names like a___b, __a__b, or a__b__ are rejected (verified by tests/test_models.py).

License

MIT