MCP Quickstart

Um servidor MCP básico do Guia de Início Rápido, adaptado para a API Chat Completions da OpenAI.

Documentação

Projetos de Aprendizado MCP

Projetos práticos para entender como construir aplicações usando Model Context Protocol (MCP).

Projetos

weather/ — Servidor MCP + Cliente Personalizado

Um servidor MCP de clima construído a partir do MCP Quickstart oficial, estendido com um cliente Python MCP personalizado que roteia chamadas de ferramentas através das APIs OpenAI Chat Completions e Responses.

calculator/ — Servidor MCP com Recursos e Interface Interativa

Um servidor MCP de calculadora que demonstra recursos MCP e MCP Apps — uma extensão que renderiza um widget interativo de calculadora HTML diretamente dentro do Claude Desktop.

chatkit/ — Aplicação Web de Chat com Backend MCP

Uma aplicação de chat full-stack construída sobre o OpenAI ChatKit. O frontend é uma aplicação React + Vite; o backend é um servidor FastAPI que roteia mensagens para servidores de ferramentas MCP com base no modo de compositor selecionado.

  • Modo Eco — ecoa a entrada do usuário de volta literalmente
  • Modo Clima — executa um agente LangChain apoiado pelo servidor MCP weather/; chamadas de ferramentas (get_alerts, get_forecast) são transmitidas ao vivo para a interface como um fluxo de trabalho com indicadores de status por etapa

Requer Python 3.14+ para o backend.

Requisitos

  • Python 3.13+ e uv
  • Node.js 18+ e npm (para chatkit/)
  • Claude Desktop (para a interface MCP Apps no projeto da calculadora)
  • Chave da API OpenAI (para o cliente de clima e o agente de clima do chatkit)

Consulte o README.md de cada subpasta para instruções de configuração e execução.