MCP Architect

Was dieser Skill macht

• Entwirft aus einer Beschreibung einen MCP-Server: Primitives (Tools/Resources/Prompts), Least-Privilege-Oberfläche
• Schreibt **korrekte Tool-Schemas** (JSON Schema 2020-12), Beschreibungen, Output-Schemas und ehrliche Annotations
• Scaffoldet lauffähigen Code für **Python (FastMCP)** oder **TypeScript (SDK)** — mit sauberem stdout
• Wählt den **Transport** (stdio lokal / Streamable HTTP remote) und plant **OAuth 2.1** für Remote-Server
• Begleitet **Testing** (MCP Inspector) und die typischen Fehler (der stdout-„disconnected"-Klassiker)
• Erzeugt eine gültige **`server.json`** und führt durch das Publishing in der offiziellen MCP-Registry
• Zwei defensive Node-Skripte: **Server-Scaffolder** + **server.json-Validator** (0 Abhängigkeiten)

Beschreibung

MCP Architect ist ein Skill für das Bauen von Model-Context-Protocol-Servern (MCP) — er verwandelt eine Beschreibung („lass Claude unsere Postgres abfragen", „mach unsere API zu Tools") in einen gut designten, sicheren, **lauffähigen** MCP-Server. Das Kernprinzip: **Ein MCP-Server ist nur so gut wie seine Tool-Schemas** — rund 80 % der Qualität. Deshalb designt er zuerst die Schnittstelle, dann den Code: die passenden **Primitives** (Tools, Resources, Prompts, nur was der Anwendungsfall braucht), klare Namen, **modell-lesbare Beschreibungen**, beschränkte Eingabe-Schemas (JSON Schema 2020-12, Objekt-Root — nie eine freie `url`/`path`/`cmd` auf einer mächtigen Aktion), strukturierte Ausgaben und ehrliche **Annotations** (readOnly/destructive/idempotent/openWorld — informative Hinweise, keine Sicherheitsgrenze). Er kennt die Realität der **2026-07-28-Spec**: stateless Core, **stdout ist der JSON-RPC-Kanal** (ein einziges `print()` bricht den Server → „disconnected", darum gehen alle Logs auf stderr), **Streamable HTTP** statt des deprecateten SSE-Transports, und dass Roots/Sampling/Logging deprecated sind. Er wählt den **Transport** passend zur Komplexität: stdio für lokal (keine Auth), Streamable HTTP für remote — und dann **OAuth 2.1 richtig** (Resource Server, RFC 9728 Metadata, RFC 8707 Resource Indicators, PKCE S256, `aud`-Prüfung, Origin validieren, lokal an 127.0.0.1 binden). Er scaffoldet lauffähigen Code für **Python (FastMCP 2.x)** oder **TypeScript (@modelcontextprotocol/sdk)** — mit zwei mitgelieferten, abhängigkeitsfreien Node-Skripten: einem **Server-Scaffolder** (korrekter Starter mit sauberem stdout, Schema, Annotations) und einem **server.json-Validator** für die offizielle **MCP-Registry**. Getestet wird mit dem **MCP Inspector**; veröffentlicht über `server.json` + Registry. Er ist **verify-live** (MCP ändert sich monatlich → aktuelle Spec/SDK mit Version), erfindet keine API-Details und ist **secure-by-design** (Least Privilege, Human-Gates) — für das Security-Tiefenaudit eines fertigen Servers verweist er auf **Agent Warden**.

Beispiele

Getestet mit Claude Code

import logging, sys; logging.basicConfig(stream=sys.stderr)   # Logs auf stderr — stdout ist JSON-RPC
from fastmcp import FastMCP
mcp = FastMCP("pg-reader")

REPORTS = {"active_users": "select id,email from users where active"}  # Allowlist, parametrisiert

@mcp.tool(annotations={"readOnlyHint": True, "openWorldHint": True})
def run_report(report: str, limit: int = 100) -> str:
    """Führt einen vorab freigegebenen, rein lesenden Report aus."""
    if report not in REPORTS: return f"Fehler: unbekannter Report. Verfügbar: {', '.join(REPORTS)}"
    return "(stub) Zeilen…"

if __name__ == "__main__": mcp.run()

Was es nicht macht

• **Kein Hosting/Runtime** — er designt und scaffoldet; Betrieb/Deployment liegt bei dir
• **Kein Security-Auditor** — für das Tiefenaudit eines fertigen Servers (Prompt Injection, Tool-Poisoning, Excessive Agency) → Agent Warden
• **Erfindet keine Spec-/API-Details** — MCP ändert sich monatlich, verify-live mit Versionsangabe
• **Kein klassisches Backend-/API-Engineering** jenseits der MCP-Schicht und kein Client-/Agenten-Bau

Kompatibilität & Technik

Geprüft (intern)

3 Szenarien

Empfohlene Laufzeit

Claude Opus oder Sonnet; mit Web-Zugriff für verify-live gegen die aktuelle MCP-Spec/SDK-APIs. Die Skripte brauchen Node (ohne Zusatzpakete); ohne Node erzeugt der Skill Code/Metadaten von Hand aus den References.

Modi

Design (Schnittstelle entwerfen) · Scaffold / Bauen (Code generieren) · Tool-Design (Schema, Annotations, Fehler) · Auth & Transport · Publishing (server.json / Registry)

Eingaben

Beschreibung des gewünschten Servers · API-/Datenbank-/Tool-Spezifikation · vorhandener MCP-Server-Code (zum Verbessern) · Sprache/SDK-Wunsch (Python/TypeScript)

Ausgabeformat

MCP-Server-Design (Primitives + Tool-Tabelle) + lauffähiger Code (Python/TypeScript) + Auth-/Transport-Plan + Test- & Publishing-Schritte

Unterkategorie

MCP-Server & KI-Tool-Integration

Lizenz

Proprietär

Sicherheitsprofil

Lieferumfang

• mcp-architect-1.0.0/11 Dateien
  • .claude-plugin/marketplace.json
  • plugins/mcp-architect/skills/mcp-architect/11 Dateien

    • SKILL.md
    • manifest.json
    • references/7 Dateien

      • mcp-architect-auth-transport.md
      • mcp-architect-publish.md
      • mcp-architect-python-fastmcp.md
      • mcp-architect-spec.md
      • mcp-architect-test-debug.md
      • mcp-architect-tool-design.md
      • mcp-architect-typescript-sdk.md
    • scripts/2 Dateien

      • scaffold-mcp.mjs
      • validate-server-json.mjs
  • .agents/skills/mcp-architect/→ universell — gleicher Inhalt (Codex, Cursor, Copilot, Gemini, Windsurf, Cline)
  • LICENSE.txt

Installation

Auch als Chat-Prompt nutzbar

Hinweis

MCP entwickelt sich monatlich weiter — mit Web-Zugriff prüft MCP Architect die aktuelle Spec (modelcontextprotocol.io) und die SDK-APIs live und nennt die Version (dieser Skill zielt auf die 2026-07-28-Spec). Er entwirft und scaffoldet; Betrieb/Deployment des Servers liegt bei dir. Für ein Security-Tiefenaudit eines fertigen Servers → Agent Warden. Die mitgelieferten Skripte brauchen Node (ohne Zusatzpakete).

Änderungen

• v1.0.021.08.2026Erstveröffentlichung: baut aus einer Beschreibung einen sauberen, sicheren MCP-Server (Model Context Protocol). Design der Primitives (Tools/Resources/Prompts), korrekte Tool-Schemas + Annotations, Transport-Wahl (stdio vs. Streamable HTTP), Code-Scaffolding für Python (FastMCP) oder TypeScript (@modelcontextprotocol/sdk) mit sauberem stdout, OAuth 2.1 für Remote-Server, Testing (MCP Inspector) und Publishing (server.json / offizielle Registry). Stand MCP-Spec 2026-07-28 (stateless Core, SSE deprecated). 2 Node-Skripte (Server-Scaffolder, server.json-Validator), 7 References. verify-live; Security-Tiefenaudit → Agent Warden.

Häufige Fragen