MCP Quickstart

A basic MCP server from the Quickstart Guide, adapted for OpenAI's Chat Completions API.

GitHub

Documentation

MCP Learning Projects

Hands-on projects for understanding how to build applications using Model Context Protocol (MCP).

Projects

weather/ — MCP Server + Custom Client

A weather MCP server built from the official MCP Quickstart, extended with a custom Python MCP client that routes tool calls through the OpenAI Chat Completions and Responses APIs.

calculator/ — MCP Server with Resources and Interactive UI

A calculator MCP server that demonstrates MCP resources and MCP Apps — an extension that renders an interactive HTML calculator widget directly inside Claude Desktop.

chatkit/ — Chat Web App with MCP Backend

A full-stack chat application built on OpenAI ChatKit. The frontend is a React + Vite app; the backend is a FastAPI server that routes messages to MCP tool servers based on the selected composer mode.

  • Echo mode — echoes user input back verbatim
  • Weather mode — runs a LangChain agent backed by the weather/ MCP server; tool calls (get_alerts, get_forecast) are streamed live to the UI as a workflow with per-step status indicators

Requires Python 3.14+ for the backend.

Requirements

  • Python 3.13+ and uv
  • Node.js 18+ and npm (for chatkit/)
  • Claude Desktop (for MCP Apps UI in the calculator project)
  • OpenAI API key (for the weather client and chatkit weather agent)

See each subfolder's README.md for setup and run instructions.