Початок роботи

Уперше маєте справу з MCP або з цим SDK? Почніть звідси. Ці сторінки проведуть від нуля до робочого, протестованого сервера: встановіть SDK, напишіть свій перший сервер, під'єднайте його до справжнього хоста і протестуйте за допомогою клієнта в пам'яті.

Запуск коду

Усі блоки коду можна копіювати й використовувати як є: це повні робочі файли.

Щоб іти слідом за викладом, вставте блок у файл server.py і відкрийте його в MCP Inspector:

uv run mcp dev server.py

НАПОЛЕГЛИВО радимо набрати (або скопіювати) код, відредагувати його й запустити локально. Саме робота у власному редакторі показує суть: як мало доводиться писати, автодоповнення, перевірка типів, що ловить помилки ще до запуску.

Гадати не доведеться

Кожен приклад у цій документації — повний файл у каталозі docs_src/ репозиторію самого SDK, і кожен із них проганяється тестовим набором SDK через клієнт у пам'яті:

import pytest
from mcp import Client

from server import mcp


@pytest.mark.anyio
async def test_add() -> None:
    async with Client(mcp) as client:
        result = await client.call_tool("add", {"a": 1, "b": 2})
        assert result.structured_content == {"result": 3}

Ні підпроцесу, ні порту, ні транспорту. Client(mcp) під'єднується безпосередньо до об'єкта сервера.

Якщо зміна в SDK зламає приклад на одній із цих сторінок, CI почервоніє раніше, ніж сторінка. Код, який ви тут читаєте, — це код, який виконується.

Ви самі скористаєтеся цим на сторінці Тестування: власні сервери тестують так само.

Куди далі

Щойно сервер запрацює, решта цієї документації — довідник, а не курс. Кожна сторінка самодостатня, тож переходьте одразу до потрібного:

• Те, що сервер надає назовні (інструменти, ресурси, промпти), — це Сервери.
• Те, що доступне всередині функцій, які ви реєструєте, — це Усередині обробника.
• Як донести сервер до клієнтів (stdio, HTTP, ваш наявний FastAPI-застосунок) — це Запуск сервера.
• Побудова іншої сторони — застосунку, що використовує MCP-сервери, — це Клієнти.