02. Arquitectura Cliente-Servidor de MCP

La Arquitectura Interna de MCP

Causita, para dominar MCP debes entender cómo fluyen los mensajes entre el modelo de Inteligencia Artificial y tu máquina local.

┌─────────────────────────────────────────────────────────┐
│                     Host (App)                          │
│       (Claude Desktop / Claude Code / Cursor)           │
│                                                         │
│   ┌─────────────────────────────────────────────────┐   │
│   │                   MCP Client                    │   │
│   └────────────────────────┬────────────────────────┘   │
└────────────────────────────┼────────────────────────────┘
                             │  JSON-RPC 2.0 (stdio / SSE)
┌────────────────────────────┴────────────────────────────┐
│                    MCP Server 1                         │
│             (PostgreSQL / Filesystem / Git)             │
└─────────────────────────────────────────────────────────┘

Componentes de la Arquitectura

Host Application: La interfaz donde interactúas con la IA (ej: Claude Desktop, Claude Code CLI, Cursor IDE).
MCP Client: El módulo interno en el Host que mantiene la conexión 1 a 1 con cada servidor MCP.
MCP Server: Tu ejecutable local en Node.js, Python o Go que expone herramientas y datos seguros.

Mecanismos de Transporte (Transports)

stdio (Standard I/O): El servidor corre como un proceso hijo local. El cliente envía mensajes JSON-RPC a través de stdin y recibe respuestas en stdout. Es el método más seguro y rápido para herramientas locales.
SSE (Server-Sent Events): Conexión vía HTTP para servidores MCP remotos o desplegados en la nube.

claude_desktop_config.jsonjson

{
"mcpServers": {
  "filesystem": {
    "command": "npx",
    "args": [
      "-y",
      "@modelcontextprotocol/server-filesystem",
      "/home/user/Documentos"
    ]
  }
}
}

Logs limpios en stdio

En los servidores MCP basados en stdio, NUNCA uses console.log() para imprimir texto común, ya que corromperá el flujo JSON-RPC. Usa console.error() para enviar mensajes de depuración.

Ejercicio Práctico Ninja 🥷

Abre tu archivo de configuración de Claude Desktop o Claude Code.
Añade el servidor oficial @modelcontextprotocol/server-filesystem.
Reinicia el cliente y comprueba que la IA pueda leer archivos de tu carpeta autorizada.