MCP Architect

Qué hace este skill

• Diseña un servidor MCP a partir de una descripción: primitivos (tools/resources/prompts), superficie de mínimo privilegio
• Escribe **esquemas de herramientas correctos** (JSON Schema 2020-12), descripciones, esquemas de salida y anotaciones honestas
• Genera código ejecutable para **Python (FastMCP)** o **TypeScript (SDK)** — con stdout limpio
• Elige el **transporte** (stdio local / Streamable HTTP remoto) y planifica **OAuth 2.1** para remoto
• Guía las **pruebas** (MCP Inspector) y los fallos comunes (el clásico stdout «disconnected»)
• Genera un **`server.json`** válido y acompaña la publicación al Registro MCP oficial
• Dos scripts de Node defensivos: **generador de servidor** + **validador de server.json** (sin dependencias)

Descripción

MCP Architect es un skill para construir servidores Model Context Protocol (MCP) — convierte una descripción («deja que Claude consulte nuestra Postgres», «expón nuestra API como herramientas») en un servidor MCP bien diseñado, seguro y **ejecutable**. La regla central: **un servidor MCP vale lo que sus esquemas de herramientas** — cerca del 80 % de la calidad. Por eso diseña primero la interfaz y luego el código: los **primitivos** correctos (tools, resources, prompts — solo lo que el caso de uso necesita), nombres claros, **descripciones legibles por el modelo**, esquemas de entrada restringidos (JSON Schema 2020-12, raíz objeto — nunca una `url`/`path`/`cmd` libre en una acción potente), salidas estructuradas y **anotaciones** honestas (readOnly/destructive/idempotent/openWorld — pistas informativas, no una frontera de seguridad). Conoce la realidad de la **spec 2026-07-28**: un núcleo stateless, **stdout es el canal JSON-RPC** (un solo `print()` rompe el servidor → «disconnected», por eso todos los logs van a stderr), **Streamable HTTP** en vez del transporte SSE obsoleto, y que Roots/Sampling/Logging están obsoletos. Elige el **transporte** según la complejidad: stdio para local (sin auth), Streamable HTTP para remoto — y luego **OAuth 2.1 bien hecho** (resource server, metadata RFC 9728, resource indicators RFC 8707, PKCE S256, validación del `aud`, validar Origin, bind a 127.0.0.1 en local). Genera código ejecutable para **Python (FastMCP 2.x)** o **TypeScript (@modelcontextprotocol/sdk)** — con dos scripts de Node incluidos, sin dependencias: un **generador de servidor** (starter correcto con stdout limpio, esquema, anotaciones) y un **validador de server.json** para el **Registro MCP** oficial. Las pruebas van con el **MCP Inspector**; la publicación vía `server.json` + Registro. Es **verify-live** (MCP cambia cada mes → spec/SDK actual con versión), no inventa detalles de API y es **secure-by-design** (mínimo privilegio, aprobaciones humanas) — para la auditoría de seguridad profunda de un servidor terminado, remite a **Agent Warden**.

Ejemplos

Probado con Claude Code

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

REPORTS = {"active_users": "select id,email from users where active"}  # allow-list, parametrizado

@mcp.tool(annotations={"readOnlyHint": True, "openWorldHint": True})
def run_report(report: str, limit: int = 100) -> str:
    """Ejecuta un reporte pre-aprobado, de solo lectura."""
    if report not in REPORTS: return f"Error: reporte desconocido. Disponibles: {', '.join(REPORTS)}"
    return "(stub) filas…"

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

Qué no hace

• **Sin hosting/runtime** — diseña y genera; ejecutar/desplegar es cosa tuya
• **No es un auditor de seguridad** — para la auditoría profunda de un servidor terminado (inyección de prompts, tool poisoning, agencia excesiva) → Agent Warden
• **No inventa detalles de spec/API** — MCP cambia cada mes, verify-live con versión
• **No es ingeniería backend/API clásica** más allá de la capa MCP, ni construcción de cliente/agente

Compatibilidad y técnica

Probado (interno)

3 escenarios

Runtime recomendado

Claude Opus o Sonnet; con acceso web para verify-live frente a las APIs de la spec/SDK MCP actuales. Los scripts necesitan Node (sin paquetes); sin Node, el skill produce el código/los metadatos a mano desde las referencias.

Modos

Diseño (dar forma a la interfaz) · Generación / build (producir código) · Diseño de herramientas (esquema, anotaciones, errores) · Auth y transporte · Publicación (server.json / Registro)

Entradas

descripción del servidor deseado · especificación de API / base de datos / herramienta · código de servidor MCP existente (para mejorar) · preferencia de lenguaje/SDK (Python/TypeScript)

Formato de salida

Diseño del servidor MCP (primitivos + tabla de herramientas) + código ejecutable (Python/TypeScript) + plan de auth/transporte + pasos de prueba y publicación

Subcategoría

Servidores MCP e integración de herramientas de IA

Licencia

Proprietär

Perfil de seguridad

Qué incluye

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

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

      • 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 archivos

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

Instalación

También como prompt de chat

Nota

MCP evoluciona cada mes — con acceso web, MCP Architect verifica en vivo la spec actual (modelcontextprotocol.io) y las APIs de los SDK y cita la versión (este skill apunta a la spec 2026-07-28). Diseña y genera; ejecutar/desplegar el servidor es cosa tuya. Para una auditoría de seguridad profunda de un servidor terminado → Agent Warden. Los scripts incluidos necesitan Node (sin paquetes adicionales).

Historial de cambios

• v1.0.021.08.2026Primera versión: convierte una descripción en un servidor MCP (Model Context Protocol) limpio, seguro y ejecutable. Diseña los primitivos (tools/resources/prompts), escribe esquemas de herramientas + anotaciones correctos, elige el transporte (stdio vs Streamable HTTP), genera código Python (FastMCP) o TypeScript (@modelcontextprotocol/sdk) con stdout limpio, planifica OAuth 2.1 para servidores remotos, y guía las pruebas (MCP Inspector) y la publicación (server.json / Registro oficial). Apunta a la spec MCP 2026-07-28 (núcleo stateless, SSE obsoleto). Dos scripts de Node (generador de servidor, linter de server.json), 7 referencias. Verify-live; auditoría de seguridad profunda → Agent Warden.

Preguntas frecuentes