DeepSeek MCP Server
MCP-сервер подключает модели DeepSeek V4.1 Flash и V4 Pro к Claude Code и Codex с картинками, FIM и Responses API
- 366 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Сервер отправляет тексты, код и загруженные картинки во внешний API DeepSeek
- Ключ DeepSeek API передается в переменной окружения, запросы расходуют платный баланс
- Загруженные файлы хранятся в вашем аккаунте DeepSeek, пока не истечет срок или вы не удалите их
Установка
- Работает в
Ручная установка
claude mcp add deepseek --env DEEPSEEK_API_KEY=REPLACE_WITH_DEEPSEEK_KEY -- npx -y deepseek-mcp-server@1Подставьте свой ключ DeepSeek API. Нужен Node.js 20 или новее.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер отправляет тексты, код и загруженные картинки во внешний API DeepSeek
- Ключ DeepSeek API передается в переменной окружения, запросы расходуют платный баланс
- Загруженные файлы хранятся в вашем аккаунте DeepSeek, пока не истечет срок или вы не удалите их
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MCP-сервер дает агенту одиннадцать инструментов для работы с API DeepSeek. Через chat_completion агент отправляет текст или текст с картинкой, управляет глубиной рассуждения, вызывает функции и получает ответ в формате JSON. Инструмент create_response обращается к Responses API без сохранения состояния и умеет вызывать пользовательский инструмент apply_patch. Инструмент completion дописывает код по префиксу и суффиксу через FIM. Остальные инструменты служебные. list_models показывает модели, доступные вашему аккаунту, с лимитами контекста, а get_user_balance возвращает баланс. Для картинок есть upload_file, list_files, retrieve_file и delete_file: загруженный файл получает file_id, который можно подставлять в чат и в Responses. Беседы различаются по conversation_id: list_conversations их перечисляет, а reset_conversation очищает. Сервер запускается через npx по stdio или как локальный HTTP-адрес. Модель по умолчанию — deepseek-flash, она обслуживается версией V4.1 Flash, а deepseek-v4-pro доступна рядом. Мультимодальность здесь означает только распознавание изображений: генерировать картинки, видео и звук сервер не умеет.
Для кого. Для разработчиков с ключом DeepSeek API, которые хотят вызывать модели DeepSeek, дописывать код через FIM и следить за балансом прямо из Claude Code или Codex.
Подходит, если
- Нужно поручить DeepSeek побочную задачу из Claude Code: второе мнение по коду, черновик теста, краткое резюме файла
- Агент должен разобрать скриншот или диаграмму: картинка уходит как ссылка или data URL
- Нужно проверить остаток на счете DeepSeek и список доступных моделей одной репликой, не открывая кабинет
- Нужен FIM-дополнитель кода на префиксе и суффиксе через инструмент completion
- Вы готовите локальный HTTP-адрес с общим токеном для нескольких клиентов в доверенной сети
Не подходит, если
- Нужна генерация картинок, видео или звука: сервер распознает изображения, но создавать их не умеет
- Нужны отдельные Search и Fetch DeepSeek: инструментов для них в сервере нет, поиск доступен только через web_search в create_response на Pro
- Нужна память разговора между перезапусками: беседы живут в памяти процесса и после рестарта пропадают
- Нет ключа DeepSeek API: сервер без него не запускается
Пример запроса к агенту
Отправь diff из последнего коммита в DeepSeek и попроси найти ошибки, затем покажи ответ и остаток балансаMCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Переменные окружения
DEEPSEEK_API_KEYобязательная, секрет- Ключ DeepSeek API из кабинета разработчика
DEEPSEEK_DEFAULT_MODEL- Модель по умолчанию, обычно deepseek-flash
MCP_HTTP_AUTH_TOKENсекрет- Общий токен для защиты HTTP-режима
Ограничения
- Запросы идут в платный API DeepSeek и тарифицируются по токенам. Лимиты MCP_TOOL_RATE_LIMIT считают вызовы инструментов и расход на стороне DeepSeek не ограничивают.
- Поиск и загрузка страниц у DeepSeek стоят отдельно, по 0,75 доллара за тысячу успешных запросов. До 31 октября 2026 года вызовы из DeepSeek Harness, Claude Code и Codex бесплатны, на другие клиенты исключение не распространяется.
- Потоковый ответ собирается целиком и приходит одним результатом: частичные токены агенту не передаются.
- Docker-образ в реестре устарел и соответствует версии 0.5.0, поэтому ставьте пакет из npm.
Как отключить. Выполните claude mcp remove deepseek для Claude Code или codex mcp remove deepseek для Codex. Ключ, который вы передали в переменной окружения, лучше отозвать в кабинете DeepSeek. Загруженные картинки остаются в вашем аккаунте DeepSeek, удалите их инструментом delete_file.
Частые вопросы
Как подключить DeepSeek к Claude Code через MCP?
Выполните claude mcp add deepseek --env DEEPSEEK_API_KEY=ваш_ключ -- npx -y deepseek-mcp-server@1. Нужен Node.js 20 или новее. Для Codex CLI команда та же, но начинается с codex mcp add.
Какая модель используется по умолчанию?
deepseek-flash. Имена deepseek-v4-flash и deepseek-v4-flash-vision-exp остались временными синонимами. Модель по умолчанию меняет переменная DEEPSEEK_DEFAULT_MODEL, а конкретный запрос может указать другую, например deepseek-v4-pro.
Как отправить в DeepSeek картинку?
Передайте в chat_completion блок image_url со ссылкой либо файл как data URL в base64. Для повторного использования сначала вызовите upload_file и подставьте полученный file_id. Допустимы JPEG, PNG, GIF и WebP, один встроенный файл не больше 32 МиБ.
Как защитить HTTP-режим сервера?
По умолчанию HTTP слушает только 127.0.0.1. Для других адресов нужен MCP_HTTP_AUTH_TOKEN, тогда клиенты передают заголовок Authorization: Bearer, либо MCP_HTTP_TRUST_AUTH_GATEWAY=true за обратным прокси, который сам проверяет каждый запрос. Для браузерных клиентов добавьте список MCP_HTTP_ALLOWED_ORIGINS.
Хранит ли сервер историю разговора?
Только в памяти процесса. Если передать один conversation_id, сервер подставит предыдущие сообщения, до 200 по умолчанию (CONVERSATION_MAX_MESSAGES). После перезапуска история исчезает, а Responses API работает без состояния.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер запускает DeepSeek или локальную модель субагентом в Claude Code и Codex с собственным циклом инструментов.
MCP-сервер дает Claude Code и Codex дешевого помощника на DeepSeek для классификации, сводок и разбора текста.
MCP-сервер дает текстовым моделям зрение: берет картинку из буфера обмена, отправляет в Qwen-VL и возвращает описание словами.
Долговременная память для DeepSeek Harness с MCP-сервером: те же воспоминания доступны Claude Code, Cursor и Codex
Локальная память для Claude Code, Codex и Cursor Agent: учится на вашей активности на Mac и отдает агентам контекст со ссылками на источники по MCP
Codex MCP Server — Codex внутри Claude Code
Codex MCP Server
MCP-сервер передает задачи Codex CLI прямо из Claude Code: вопросы по коду, ревью изменений, веб-поиск и сессии с продолжением диалога
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| DeepSeek MCP Server (эта карточка) | нет | API-ключ | 366 | |
| DeepSeek Bridge для Claude Code | нет | API-ключ | 2 | передает объемную работу с файлами локальному агенту DeepSeek, прямых вызовов API в нем нет |
| DeepSeek Harness | да | 279 346 | самостоятельный агент DeepSeek со своим интерфейсом, моста в API из другого агента в нем нет |
Коротко о README
Помимо установки проект подробно разбирает особенности API DeepSeek: правила режима рассуждения, FIM и лимиты на размер файлов. В конце есть заметки для тех, кто обновляется с версии 0.6.0.