Library
The MCP field guide
Guides, tutorials, lessons, terms, releases, projects, and tools—authored in Git and reviewed in public.
Client
The MCP participant created by a host to maintain one protocol connection with one MCP server.
learning-pathMCP Fundamentals
A structured path from the protocol mental model through architecture, lifecycle, primitives, and a first inspected connection.
lessonHosts, Clients, and Servers
Identify the ownership and connection boundaries between the three core participants in an MCP architecture.
spec-releaseMCP Protocol Revision 2025-11-25
A representative Spec Watch entry for the current protocol revision and its primary implementation-impact areas.
toolAuthorization Flow Explorer
A planned interactive guide for exploring MCP authorization roles, discovery, grants, token boundaries, and implementation choices.
guideBuild a Minimal MCP Server
Build a small Python MCP server, expose a typed tool, and inspect the connection from a real development client.
guideBuilding Your First MCP Server
Learn MCP by configuring a weather server, inspecting the generated TypeScript, following current protocol messages, and testing it with the ATM learning client.
guideCreate an All Things MCP Guide
Plan, write, preview, validate, and submit an outcome-driven Guide using the project’s reviewed Markdown and MDX components.
ecosystemFilesystem MCP Server
A representative ecosystem listing showing project metadata without implying endorsement or technical verification.
guide-stepAdd a Typed Tool
Expose one deterministic addition tool with a narrow input schema and a description that clients can understand.
guide-stepCreate the Server
Define the smallest FastMCP application that can start cleanly over the local standard input and output transport.
guide-stepInspect the Connection
Launch the server with MCP Inspector and verify initialization, tool discovery, and a complete tool invocation.
guide-stepPrepare Your Environment
Create an isolated Python project and install the official MCP SDK and its development command-line tools.
guide-stepAdd Prompts
Add a reusable weather-planning prompt with explicit arguments and inspect the generated registration code.
guide-stepAdd Resources
Expose read-only weather data through a stable resource URI, metadata, and a declared MIME type.
guide-stepAdd Tools
Add callable weather operations and inspect how their descriptions and input fields become tool schemas.
guide-stepConnect the ATM Client
Connect the ATM learning client to your real MCP workspace, discover the server, and inspect the protocol exchange.
guide-stepCreate Your Server
Start a temporary Guide Runtime workspace and establish the named MCP server boundary you will configure.
guide-stepReview and Export
Review the complete MCP server, download its runnable TypeScript project, and finish the Guide.
guide-stepTest Your Server
Invoke a configured weather tool through the ATM client and inspect its request, response, and structured result.
guide-stepWhat Is MCP?
Build a practical mental model of the host, client, server, and the capabilities an MCP server can expose.
guide-stepAdd Structured Content
Present alternatives, related choices, reference metadata, and technical flows with safe and accessible structured components.
guide-stepCreate the Guide Manifest
Add the Guide overview document and define the metadata, prerequisites, resources, and ordered steps that power the experience.
guide-stepPlan the Outcome
Decide whether your contribution is a Guide, define the result a reader will produce, and outline the shortest useful sequence.
guide-stepUse Writing Components
Add code, notes, warnings, checklists, and numbered procedures using the reviewed components available to Guide authors.
guide-stepValidate and Submit
Run the authoring checks, inspect the complete Guide at desktop and mobile sizes, and prepare a focused pull request.
guide-stepWrite a Useful Step
Create a step document that matches the manifest, teaches one meaningful action, and ends with an observable checkpoint.