Перейти до змісту

Встановлення

Машинний переклад

Цю сторінку перекладено автоматично з англомовної документації, і основною версією є англомовна сторінка. Якщо щось читається неправильно, на сторінці Переклади пояснено, як про це повідомити.

Python SDK опубліковано на PyPI як mcp. Потрібен Python 3.10+.

Ця документація описує v2 — поточну стабільну лінійку випусків:

uv add "mcp[cli]"

pip install "mcp[cli]"

Переходите з v1?

v2 — мажорна версія з несумісними змінами; Посібник з міграції описує кожну з них. Якщо ваш пакет залежить від mcp і ще не готовий до міграції, залиште верхню межу <2 (наприклад, mcp>=1.28,<2), щоб розв'язання залежностей без фіксованої версії залишалося на лінійці 1.x.

Що встановлюється

Щоб користуватися SDK, нічого з цього знати не потрібно, але якщо цікаво, навіщо кожна залежність:

  • mcp-types: усі типи протоколу (запити, результати, блоки вмісту) окремим пакетом, версія якого йде в ногу з SDK. Код, що залежить від mcp, імпортує його через псевдонім mcp.types (кожне from mcp.types import ... у цій документації); імпортуйте mcp_types напряму лише в проєкті, який встановлює mcp-types без SDK.
  • anyio: асинхронне середовище виконання. Увесь SDK написано поверх anyio, тож він працює і на asyncio, і на trio.
  • pydantic: основа кожної моделі в mcp.types, а також уся генерація схем і валідація.
  • httpx2: HTTP-клієнт, на якому працюють клієнтські транспорти Streamable HTTP і SSE, із вбудованою підтримкою server-sent events.
  • starlette, uvicorn, sse-starlette і python-multipart: серверні HTTP-транспорти.
  • jsonschema: перевіряє структурований вивід інструмента на відповідність оголошеній схемі виводу.
  • pyjwt[crypto]: робота з OAuth-токенами для авторизації.
  • opentelemetry-api: лише легкий API, тож middleware трасування в SDK нічого не коштує, доки ви самі не встановите OpenTelemetry SDK і експортер.
  • typing-extensions і typing-inspection: сучасні можливості типізації на Python 3.10.
  • pywin32: лише для Windows, використовується для керування підпроцесами stdio.

Необов'язкові доповнення

  • mcp[cli] додає typer і python-dotenv для інструмента командного рядка mcp (mcp dev, mcp run, mcp install). Під час розробки він знадобиться; на розгорнутому сервері може бути зайвим.
  • mcp[rich] додає rich для охайніших логів сервера.