MCP Quickstart

Un servidor MCP básico de la Guía de inicio rápido, adaptado para la API de Chat Completions de OpenAI.

Documentación

Proyectos de Aprendizaje de MCP

Proyectos prácticos para entender cómo construir aplicaciones usando Model Context Protocol (MCP).

Proyectos

weather/ — Servidor MCP + Cliente Personalizado

Un servidor MCP de clima construido a partir del MCP Quickstart oficial, extendido con un cliente MCP personalizado en Python que enruta las llamadas a herramientas a través de las API de Chat Completions y Responses de OpenAI.

calculator/ — Servidor MCP con Recursos e Interfaz Interactiva

Un servidor MCP de calculadora que demuestra recursos MCP y MCP Apps — una extensión que renderiza un widget interactivo de calculadora HTML directamente dentro de Claude Desktop.

chatkit/ — Aplicación Web de Chat con Backend MCP

Una aplicación de chat full-stack construida sobre OpenAI ChatKit. El frontend es una aplicación React + Vite; el backend es un servidor FastAPI que enruta mensajes a los servidores de herramientas MCP según el modo compositor seleccionado.

  • Modo Eco — devuelve la entrada del usuario tal cual
  • Modo Clima — ejecuta un agente LangChain respaldado por el servidor MCP weather/; las llamadas a herramientas (get_alerts, get_forecast) se transmiten en vivo a la interfaz como un flujo de trabajo con indicadores de estado por paso

Requiere Python 3.14+ para el backend.

Requisitos

  • Python 3.13+ y uv
  • Node.js 18+ y npm (para chatkit/)
  • Claude Desktop (para la interfaz de MCP Apps en el proyecto de calculadora)
  • Clave de API de OpenAI (para el cliente de clima y el agente de clima de chatkit)

Consulta el README.md de cada subcarpeta para las instrucciones de configuración y ejecución.