ClaudeMap

Building MCP Servers (TypeScript)

Official walk-through for writing an MCP server in TypeScript.

Tutorials & Guidesofficialtutorialtypescript

Official walk-through for building an MCP server with the official SDK — now a unified tutorial covering both TypeScript and Python editions. The shortest path from 'what is MCP' to a working server Claude can call.

What it does

  • Hands-on tutorial: build a simple MCP weather server exposing two tools, get_alerts and get_forecast
  • Connects the finished server to a host — the tutorial uses Claude for Desktop for simplicity, and notes servers can connect to any client
  • Covers core MCP concepts, testing with commands, what happens under the hood, and troubleshooting
  • Versioned against the 2026-07-28 (latest) docs snapshot at the URL

When to use it

The shortest path from "what is MCP" to a working server Claude can call — start here before reading the SDK references.

Getting started

No install — the tutorial walks you through creating the server from scratch with the TypeScript SDK. Open:

https://modelcontextprotocol.io/docs/2026-07-28/develop/build-server

Things to know

The tutorial pins a specific docs version (2026-07-28) in its URL — the site also publishes newer snapshots, so check the version switcher if API shapes have moved.

Charted

Related on the map

  • Anthropic's official "Code with Claude" workshop materials — nine hands-on courses on skills, MCP, evals and Claude Managed Agents.

    • official
    • workshops
    • anthropic
    • managed-agents
  • Anthropic's canonical essay on agent design — workflows vs agents, and five composable patterns.

    • official
    • agents
    • engineering
    • patterns