02. Arquitectura Cliente-Servidor de MCP - Guía MCPs + Skills

En este módulo aprenderás:

Comprende el flujo JSON-RPC 2.0 entre la aplicación Host (Claude Desktop/Code) y Servidores MCP.
Comandos y configuraciones clave para 02. Arquitectura Cliente-Servidor de MCP
Ejercicios prácticos listos para probar en tu terminal local

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.

Topología del SistemaJSON-RPC 2.0 Protocol

Arquitectura Host ⟷ MCP Client ⟷ Transports ⟷ MCP Servers

1. APLICACIÓN HOST & LLM ENGINE

Claude Code / Antigravity / Cursor

🧠 LLM Reasoner

Decide qué herramientas invocar y sintetiza el contexto devuelto.

🛡️ Permission Gate

Solicita confirmación al usuario antes de ejecutar acciones de escritura.

Llamadas internas a la API de MCP

2. MCP CLIENT (Despachador JSON-RPC 2.0)Conexiones 1:1 persistentes

Descubrimientotools/list

Ejecucióntools/call

Recursosresources/read

Transport: stdio (Local IPC)Más Seguro

Procesos hijos en tu máquina comunicándose por pipes estándar de stdin y stdout.

📁 @mcp/server-filesystemnpx local

🐳 @mcp/server-dockerdocker socket

Transport: SSE (Server-Sent Events)Cloud / Remoto

Conexión persistente HTTP por streaming para herramientas remotas corporativas.

🐘 PostgreSQL Serverhttp://api.dev/mcp

⚡ Custom API Servicecloud endpoint

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.

¿Terminaste esta lección?

Marca tu progreso para sincronizar el avance en tu navegador.

Anterior01. Qué es MCP y por qué reemplaza Function Calling Siguiente03. Creando tu primer servidor MCP en TypeScript