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()

Beispielhafte Antworten. Je nach KI und Modell können sie abweichen.

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.1/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.124.09.2026Pflege-Update: Rückfragen nutzen jetzt das native Fragen-Werkzeug deiner Plattform (höchstens 3 Fragen, empfohlene Option zuerst, nummerierte Liste als Rückfall, blockiert nie unbeaufsichtigte Läufe). Dazu sauberere Typografie in allen ausgelieferten Dateien. Fakten, Fristen und Plattform-Angaben gegen aktuelle offizielle Quellen geprüft (Stand September 2026).
• 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