Ultimate MCP Client CLI
Асинхронный MCP-клиент на Python с командной строкой и веб-интерфейсом подключает Claude к серверам по stdio и SSE.
- 171 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Подключенные MCP-серверы могут выполнять команды и читать файлы с правами пользователя.
- Скан портов и mDNS ищут серверы в локальной сети.
Установка
Ручная установка
git clone https://github.com/Dicklesworthstone/ultimate_mcp_clientЗатем `uv venv --python 3.13` и `uv sync --all-extras` внутри папки. Запуск: `mcpclient run --webui`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Подключенные MCP-серверы могут выполнять команды и читать файлы с правами пользователя.
- Скан портов и mDNS ищут серверы в локальной сети.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Ultimate MCP Client запускает диалог с Claude и маршрутизирует вызовы инструментов к подключенным MCP-серверам. Он поддерживает транспорты `stdio`, `sse` и streaming-http и находит серверы в локальных папках, по mDNS, сканированием портов, в реестрах и в конфигурации Claude Desktop. Диалоги ветвятся как граф с сохранением в JSON, длинную историю можно сжимать командой `/optimize`. Есть кэш результатов инструментов, метрики OpenTelemetry и живая панель `mcpclient run --dashboard`.
Для кого. Разработчикам MCP-серверов, которым нужен отладочный клиент со своим интерфейсом, логами и метриками.
Подходит, если
- Новый MCP-сервер надо проверить вручную через чат и прямой вызов `/tool`.
- Нужно найти все MCP-серверы в локальной сети или на открытых портах.
- Диалог с инструментами хотят разветвить и сравнить два пути.
- Конфигурацию Claude Desktop нужно перенести в отдельный клиент.
Не подходит, если
- Нужен клиент к моделям не от Anthropic: интеграция построена на Claude.
- Сервер подключают к Claude Code или Cursor, у которых уже есть свой MCP-клиент.
- Сканирование локальных портов в сети запрещено политикой.
Пример запроса к агенту
Подключи сервер из `.mcpclient_config/servers`, покажи его инструменты и вызови один из них с тестовыми параметрами.Ограничения
Нужны Python 3.13 или новее и собственный `ANTHROPIC_API_KEY`, запросы тарифицирует Anthropic. Лицензия MIT с дополнительным условием про OpenAI и Anthropic, его текст стоит прочитать в `LICENSE`. Флаг `--host 0.0.0.0` открывает веб-интерфейс всей сети, а подключенные серверы могут выполнять команды. Конфигурация и диалоги лежат в папке проекта `.mcpclient_config/`, поэтому ключи и история хранятся рядом с кодом и их не стоит коммитить. Python 3.13 в системе может отсутствовать, а `uv` ставится отдельно.
Как отключить. Остановите клиент и удалите клонированную папку. Сохраненные диалоги и настройки лежат в `.mcpclient_config/` в корне проекта.
Частые вопросы
Как запустить веб-интерфейс?
Выполните `mcpclient run --webui`. Адрес и порт меняют флаги `--host` и `--port`.
Как задать ключ API?
Экспортируйте `ANTHROPIC_API_KEY` или впишите его в файл `.env` в корне проекта. Переменная окружения приоритетнее значения в конфигурации.
Какие серверы клиент находит сам?
Скрипты в настроенных папках, серверы в локальной сети по mDNS, серверы на портах из заданного диапазона и записи удаленных реестров.
Как сохранить диалог?
Команда `mcpclient export` пишет ветку в JSON, `mcpclient import-conv` загружает ее обратно. Диалоги также сохраняются автоматически в папке конфигурации.
Работает ли клиент с моделями не от Anthropic?
В README описана интеграция с Claude через официальный пакет `anthropic`. Других провайдеров README не называет.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыMCP-сервер, который дает Claude Desktop и другим клиентам файловые инструменты, shell и подагентов в духе Claude Code
Прозрачный прокси между ИИ-клиентом и MCP-сервером: показывает каждый кадр JSON-RPC в терминале, проверяет запись в CI и экспортирует спаны
MCP-сервер, который дает агенту поиск по большому руководству Claude Code, официальной документации, релизам и готовым шаблонам
Клиент в терминале и браузере открывает чат с моделью Anthropic и любым MCP-сервером, чтобы проверить его инструменты.
Консольный отладчик MCP-серверов от Giant Swarm: REPL для инструментов, OAuth 2.1 и режим MCP-сервера для Cursor
Легкий CLI, чтобы находить, смотреть и вызывать инструменты MCP-серверов прямо из командной строки
Коротко о README
Клиент написан на Python с FastAPI для веб-части и Typer для командной строки. README подробно описывает транспорты, обнаружение серверов, управление диалогами и наблюдаемость.