modelcontextprotocol/python-sdk

The official Python SDK for Model Context Protocol servers and clients

MCP⭐ 24 785Pythonпоследний релиз: v2.3.0

Что это за инструмент

Официальный Python SDK для создания серверов и клиентов протокола Model Context Protocol (MCP).

Зачем нужен

Позволяет разработчикам безопасно и стандартизированно экспонировать данные и функциональность (инструменты, ресурсы, промпты) для LLM-приложений. Упрощает интеграцию, устраняя необходимость писать код для парсинга запросов, валидации и обработки JSON Schema.

Что можно реализовать

Создание MCP-серверов, предоставляющих инструменты и ресурсы для хостов LLM
Разработка MCP-клиентов для подключения к серверам через stdio, Streamable HTTP или SSE
Локальная разработка и тестирование серверов с помощью MCP Inspector
Интеграция LLM-приложений с внешними данными через стандартизированный протокол

Ключевые возможности

Автоматическая генерация JSON Schema на основе аннотаций типов Python
Поддержка всех стандартных транспортов: stdio, Streamable HTTP, SSE
Возможность подключения к серверам по URL, через подпроцессы или напрямую в памяти
Простой API: сервер можно создать, определив всего пару декорированных функций
Лицензия MIT и поддержка Python 3.10+

👤 Кому подойдёт: Разработчики, создающие LLM-приложения, агенты или интеграции с внешними источниками данных, использующие Python.

Релизы

v2.3.0minorbreaking

🕐 1 мес назад · релиз на GitHub ↗

Релиз v2.3.0: новые параметры SSE и подписок, строгая валидация заголовков и исправления стабильности.

Breaking: Теперь требуется httpx>=2.10.0 для поддержки опции max_sse_event_size.
Breaking: Некорректные аннотации x-mcp-header вызывают ошибку InvalidSignature при регистрации инструмента.
Breaking: Пустые объекты _meta и params больше не отправляются; в контексте они теперь равны None.
Added: Добавлен параметр max_sse_event_size для управления размером событий SSE в StreamableHttpParameters.
Added: MCPServer поддерживает отключение подписок через параметр subscriptions=False.
Fixed: Интерактивный вход OAuth больше не прерывается таймаутом запроса во время ожидания редиректа.

v2.2.0majorbreaking

🕐 2 мес назад · релиз на GitHub ↗

В MCP Python SDK v2.2.0 ужесточена безопасность OAuth, добавлены лимиты сессий и изменено поведение редиректов.

Breaking: HTTP-клиенты теперь следуют редиректам только в пределах исходного домена, протокола и порта.
Breaking: Включена автоматическая инвалидация неактивных Streamable HTTP сессий через 30 минут.
Breaking: OAuth-клиенты строго проверяют поле issuer в метаданных сервера авторизации.
Deprecated: Создание OAuth-провайдеров без указания параметра issuer теперь вызывает предупреждение об устаревании.
Added: Добавлена настройка validate_token_resource для проверки ресурса в токенах.
Fixed: Исправлено освобождение сессий при удалении и корректная обработка $ref в схемах инструментов.

v2.1.1patch

🕐 2 мес назад · релиз на GitHub ↗

В версии 2.1.1 обновлены импорты mcp.server.fastmcp для указания на руководство по миграции.

Fixed: Исправлены импорты модуля mcp.server.fastmcp, теперь они ссылаются на руководство по миграции.

v2.1.0minorbreaking

🕐 2 мес назад · релиз на GitHub ↗

MCP Python SDK v2.1.0: поддержка медиа в промптах, прямая передача StdioServerParameters, новые правила обработки ошибок и лимиты SSE.

Added: Промпты теперь принимают изображения и аудио, а Client принимает StdioServerParameters напрямую.
Breaking: Неожиданные исключения хендлеров логируются как Error, а клиенту возвращается общая ошибка; для модели используйте ToolError.
Breaking: Возврат контент-блоков (TextContent, Image и др.) больше не включает outputSchema или structuredContent по умолчанию.
Added: Лимит тела запроса 4 МБ теперь применяется к SSE-транспорту и OAuth-эндпоинтам.
Fixed: Исправлена сериализация NotRequired в TypedDict, поддержка Python 3.10 и корректный ответ 202 для уведомлений.

v2.0.0majorbreaking

🕐 3 мес назад · релиз на GitHub ↗

Вышел стабильный MCP Python SDK v2: поддержка протокола 2026-07-28, новый MCPServer, авто-клиент и строгая миграция с v1.

Added: Поддержка протокола MCP 2026-07-28 с сохранением обратной совместимости с клиентами 2025 года.
Added: Полный редизайн: декораторный API перенесен в MCPServer, а Client теперь единый объект для подключения.
Added: Внедрены многоэтапные запросы, инъекция зависимостей через Resolve(fn) и автоматическая трассировка OpenTelemetry.
Breaking: v1.x переведен в режим поддержки: принимаются только патчи безопасности, требуется ручная миграция на v2.
Fixed: Усилены безопасность stdio-серверов и OAuth: добавлена валидация издателя, SEP-990 и защита от переполнения буфера.

v1.28.1minor

🕐 4 мес назад · релиз на GitHub ↗

Релиз v1.28.1: добавлена поддержка TransportSecuritySettings для WebSocket, улучшена буферизация StreamableHTTP и обновлён статус стабильности.

Added: Добавлена поддержка TransportSecuritySettings в серверном транспорте WebSocket.
Added: Реализована буферизация потоков StreamableHTTP на уровне запроса с сохранением события инициализации перед отправкой.
Added: Классификатор статуса разработки изменён на Production/Stable.