Mindket
IntermediateFree

MCP course: build, test and connect MCP servers

A black banner titled "MCP course". Its line reads "Build an MCP server in Python or TypeScript, test it, connect it".

This free MCP tutorial teaches you to build an MCP server in Python or TypeScript with the official SDKs, test it with MCP Inspector and connect it to Claude Desktop, Cursor and VS Code. It has four hands-on lessons, and every command and config is copied from the official docs. You need basic Python or TypeScript and a terminal.

What you'll be able to do

  • Build a working MCP server in Python with the official SDK, and again in TypeScript.
  • Register tools whose schemas come from Python type hints or a Zod schema, and keep stdout clean so the protocol survives.
  • Test any server in MCP Inspector, in the browser or from the command line, and read the JSON-RPC messages behind a call.
  • Connect a local server to Claude Desktop, Cursor and VS Code with the right config file, top-level key and absolute paths.
  • Find out why a server fails to connect by reading each app's logs.
All courses

Who it's for

For developers who are comfortable with Python or TypeScript and a terminal and want to write their own MCP servers. You need Python 3.11 or newer, or Node.js 20 or newer, plus a patched Node.js for the Inspector: 22.23.4, 24.22.1 or 26.12.1, or later on each line. If you want the protocol explained first, read the Mindket post on what MCP is.

Lessons

  1. 1Build an MCP server in Python with the official SDKBuild a Python MCP server with the official SDK: install it with uv, write two tools, run it over stdio, then check it in MCP Inspector and Claude Desktop.8 min
  2. 2Build an MCP server in TypeScript with the official SDKBuild a TypeScript MCP server with the official SDK: set up the project, register a tool with a Zod schema, serve it over stdio and call it from the Inspector.7 min
  3. 3MCP Inspector: test and debug an MCP serverLearn MCP Inspector: launch it on a local or remote server, call tools in the browser, read the protocol log and run the same checks from the command line.11 min
  4. 4Connect an MCP server to Claude Desktop, Cursor and VS CodeConnect an MCP server to Claude Desktop, Cursor and VS Code: each app's config file, its JSON format, how to reload it and where to look when nothing shows up.8 min

Frequently asked questions

Is this MCP course free?

Yes. All four lessons are free to read, and every command and config in them is copied from the official documentation, with its source listed at the end of the lesson.

Do I need to know both Python and TypeScript?

No. Lesson 1 builds the server in Python and lesson 2 builds a server in TypeScript. The Inspector and connection lessons work with either, so you can follow the whole course in the language you prefer.

How long does the MCP course take?

Reading all four lessons takes about half an hour. Building and testing the servers takes longer, depending on how much of the code you type yourself.

Which MCP SDK versions does it use?

The Python lessons use SDK 2.x, where the server class is MCPServer. The TypeScript lessons use the package @modelcontextprotocol/server from the v2 line. Older tutorials use FastMCP and @modelcontextprotocol/sdk, so check the names before you copy code.

Does the course cover Claude Code?

The connection lesson covers Claude Desktop, Cursor and VS Code. Claude Code has its own guide on Mindket, on adding an MCP server to Claude Code.

Share this course

See what is already built

Browse the MCP servers on Mindket before you write your own.

Browse MCP servers

All courses · All articles