Repolode
Предложить
Dicklesworthstone

Dicklesworthstone/ultimate_mcp_client

Асинхронный Python-клиент для Model Context Protocol с интерактивным CLI и веб-интерфейсом для подключения моделей ИИ к MCP-серверам через stdio, SSE и streaming-HTTP.

Открыть на GitHub
Звёзды
171
Форки
23
Открытые issues
0
Последний коммит
8 дней назад

Что это?

Ultimate MCP Client — это Python-клиент для Model Context Protocol (MCP), который стандартизирует доступ моделей ИИ к внешним инструментам, ресурсам и промптам. Он подключает модели Claude через Anthropic SDK к MCP-серверам, запущенным как локальные процессы stdio или удалённые конечные точки SSE и streaming-HTTP, и направляет вызовы инструментов на сервер, который их предоставляет.

В проекте есть два интерфейса, работающих поверх одного ядра: веб-интерфейс на FastAPI, WebSockets, Alpine.js и DaisyUI, а также CLI на Typer и Rich со slash-командами, интерактивной TUI-панелью и пакетными запросами. Диалоги хранятся в виде разветвлённого графа: ветки можно форкать и переключать, диалоги — сокращать с учётом ограничений контекста, а данные — экспортировать в JSON и импортировать из него.

Поиск серверов охватывает локальные каталоги со скриптами, импорт конфигурации Claude Desktop (с адаптацией путей WSL), удалённые реестры, mDNS в локальной сети и необязательное сканирование портов. Результаты инструментов можно кэшировать на диске, задавая TTL для каждой категории и автоматическую инвалидацию на основе зависимостей; также встроена поддержка метрик и трассировок OpenTelemetry.

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

  • 01Подключается к MCP-серверам через транспорты stdio, SSE и streaming-HTTP.
  • 02Веб-интерфейс с потоковой передачей сообщений в реальном времени, управлением серверами и визуализацией веток диалога.
  • 03Интерактивный CLI со slash-командами, отображением Markdown и динамической TUI-панелью.
  • 04Разветвлённый граф диалогов с возможностью создавать и переключать ветки, сокращать диалоги, импортировать и экспортировать данные.
  • 05Ищет серверы в локальных каталогах и удалённых реестрах, в конфигурации Claude Desktop и через mDNS и сканирование портов.
  • 06Кэширует результаты инструментов с TTL и инвалидацией на основе зависимостей.

Сценарии использования

  • Экспериментировать с MCP-инструментами в Claude без написания собственного клиента.
  • Тестировать и отлаживать локальный MCP-сервер с логированием JSON-RPC и отдельными логами stderr для каждого сервера.
  • Запустить собственный чат-интерфейс, который подключает Claude к локальным и удалённым серверам инструментов.
  • Исследовать альтернативные варианты диалога, создавая и сравнивая ветки.

Быстрый старт

  1. 1

    Установите uv (запустите официальный скрипт установки из README)

  2. 2

    Клонируйте репозиторий

    git clone https://github.com/Dicklesworthstone/ultimate_mcp_client
  3. 3

    Установите зависимости (требуется Python 3.13 или новее)

    uv sync --all-extras
  4. 4

    Запустите Web UI (сначала задайте ANTHROPIC_API_KEY)

    mcpclient run --webui

Что важно знать

  • Требуется Python 3.13 или новее.
  • Для использования моделей Claude нужен ключ API Anthropic.
  • Лицензия указана как нестандартная (MIT с дополнительным условием для OpenAI/Anthropic), поэтому перед коммерческим использованием ознакомьтесь с её условиями.

Темы

#mcp#ai-agents#anthropic#claude#python#asyncio#cli#web-ui

Частые вопросы

Что такое ultimate_mcp_client?
Асинхронный Python-клиент для Model Context Protocol с интерактивным CLI и веб-интерфейсом для подключения моделей ИИ к MCP-серверам через stdio, SSE и streaming-HTTP. Ultimate MCP Client — это Python-клиент для Model Context Protocol (MCP), который стандартизирует доступ моделей ИИ к внешним инструментам, ресурсам и промптам. Он подключает модели Claude через Anthropic SDK к MCP-серверам, запущенным как локальные процессы stdio или удалённые конечные точки SSE и streaming-HTTP, и направляет вызовы инструментов на сервер, который их предоставляет.
ultimate_mcp_client можно использовать бесплатно? Какая у него лицензия?
ultimate_mcp_client распространяется с открытым исходным кодом под лицензией Other. Перед использованием в коммерческих продуктах проверьте условия лицензии.
ultimate_mcp_client всё ещё поддерживается?
Активно поддерживается. Последний коммит в ultimate_mcp_client — 14 окт. 2026 г..
Для чего можно использовать ultimate_mcp_client?
Экспериментировать с MCP-инструментами в Claude без написания собственного клиента. Тестировать и отлаживать локальный MCP-сервер с логированием JSON-RPC и отдельными логами stderr для каждого сервера. Запустить собственный чат-интерфейс, который подключает Claude к локальным и удалённым серверам инструментов. Исследовать альтернативные варианты диалога, создавая и сравнивая ветки.
Как установить ultimate_mcp_client?
Установите uv (запустите официальный скрипт установки из README) Клонируйте репозиторий: git clone https://github.com/Dicklesworthstone/ultimate_mcp_client Установите зависимости (требуется Python 3.13 или новее): uv sync --all-extras Запустите Web UI (сначала задайте ANTHROPIC_API_KEY): mcpclient run --webui
Где скачать ultimate_mcp_client?
Исходный код и инструкции по установке — на GitHub: https://github.com/Dicklesworthstone/ultimate_mcp_client

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты