arikusi/deepseek-mcp-server

MCP-сервер для DeepSeek V4: v4-flash и v4-pro с контекстом 1M, многошаговыми сессиями, вызовом функций, режимом размышлений и учётом стоимости. Интегрируется в Claude Code, Cursor, Windsurf и любые...

README

3 инструмента

Версии

Установить сервер

DeepSeek MCP Server

MCP server for DeepSeek V4 (v4-flash and v4-pro, 1M context) with multi-turn sessions, function calling, thinking mode, and cost tracking.

Compatible with Claude Code, Gemini CLI, Cursor, Windsurf, and any MCP-compatible client.
Officially listed on the MCP Registry, Smithery, Glama, LobeHub, and Fronteir AI.

v2.0.0 runs on DeepSeek V4. Two models, deepseek-v4-flash (fast and economical) and deepseek-v4-pro (top capability), both with a 1M-token context window and optional chain-of-thought thinking. Existing deepseek-chat and deepseek-reasoner setups keep working as aliases, so upgrading is drop-in.

Quick Start

Remote (No Install)

Use the hosted endpoint directly — no npm install, no Node.js required. Bring your own DeepSeek API key:

Claude Code:

claude mcp add --transport http deepseek \
  https://deepseek-mcp.tahirl.com/mcp \
  --header "Authorization: Bearer YOUR_DEEPSEEK_API_KEY"

Cursor / Windsurf / VS Code:

{
  "mcpServers": {
    "deepseek": {
      "url": "https://deepseek-mcp.tahirl.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DEEPSEEK_API_KEY}"
      }
    }
  }
}

Инструменты были проиндексированы: 09.09.2026

deepseek_chat

Общайтесь с моделями DeepSeek V4. deepseek-v4-flash (быстрая, экономичная) и deepseek-v4-pro (самая производительная), обе с контекстом 1M и опциональным режимом рассуждений chain-of-thought. deepseek-chat и deepseek-reasoner — устаревшие псевдонимы, пока принимаются для обратной совместимости (разрешаются в v4-flash), но запланированы к удалению; используйте имена v4. Возможности: многошаговые сессии (session_id), вызов функций (параметр tools), режим рассуждений, режим вывода JSON, мультимодальный ввод (когда включён), автоматический учёт затрат и откат модели с защитой circuit breaker.

DeepSeek Chat Completion

Параметры

json_modeboolean
Enable JSON output mode. The model will output valid JSON. Include the word "json" in your prompt for best results. Supported by both models.
max_tokensnumber
Maximum tokens to generate. V4 models support up to 384000 output tokens.
messagesobject[]обязательный
Array of conversation messages. Each message has role (system/user/assistant/tool) and content (string or array of content parts for multimodal). Tool messages require tool_call_id.
modelenum
Model to use. deepseek-v4-flash (default, fast/economical) or deepseek-v4-pro (most capable), both 1M context, up to 384K output. Non-thinking by default for speed; pass thinking:{type:"enabled"} to reason. Deprecated aliases (still accepted, prefer v4 names): deepseek-chat -> v4-flash non-thinking, deepseek-reasoner -> v4-flash thinking.
reasoning_effortenum
Reasoning effort while thinking mode is active: "high" (default) or "max". Only applies when thinking is enabled.
response_schemaobject
JSON Schema to validate the model output against. Implies JSON output mode. The server validates the parsed result and, on failure, issues up to RESPONSE_SCHEMA_MAX_RETRIES repair retries (feeding the validation error back). The returned content is the first schema-valid object, or the last attempt with schema.valid=false and schema.error set.
session_idstring
Session ID for multi-turn conversations. When provided, previous messages from this session are prepended to the current messages. If the session does not exist, it is created automatically. Omit for stateless single-turn requests.
streamboolean
Enable streaming mode. Returns full response after streaming completes.
temperaturenumber
Sampling temperature (0-2). Higher = more random. Default: 1.0. Ignored when thinking mode is enabled.
thinkingobject
Toggle chain-of-thought thinking mode. Use {type: "enabled"} to reason, {type: "disabled"} for a fast direct answer (the default here). When enabled, temperature/top_p are ignored.
tool_choiceenum | object
Controls which tool the model calls. "auto" (default), "none", "required", or {type:"function",function:{name:"..."}}
toolsobject[]
Array of tool definitions for function calling. Each tool has type "function" and a function object with name, description, and parameters (JSON Schema).

deepseek_fim

Заполнение середины (FIM) с помощью DeepSeek V4. Предоставьте префикс (prompt) и опциональный суффикс; модель дополняет текст между ними. Идеально подходит для дополнения кода и заполнения содержимого. Работает в режиме без рассуждений на бета-энпоинте; объём вывода ограничен 4 тысячами токенов. Устаревшие псевдонимы deepseek-chat и deepseek-reasoner по-прежнему принимаются и разрешаются в deepseek-v4-flash (у FIM нет режима рассуждений). Включает автоматическое отслеживание стоимости и откат модели с защитой от каскадных сбоев (circuit breaker).

DeepSeek FIM Completion

Параметры

max_tokensnumber
Maximum tokens to generate. FIM completions are capped at 4096 tokens by the API.
modelenum
Model to use. deepseek-v4-flash (default, fast/economical) or deepseek-v4-pro (most capable). Deprecated aliases deepseek-chat / deepseek-reasoner are still accepted and resolve to v4-flash. FIM is always non-thinking.
promptstringобязательный
The prefix text that comes before the content to generate. Required. For code completion, this is the code up to the cursor.
stopstring | string[]
Optional stop sequence(s). Generation stops when any is produced. A single string or an array of up to 16 strings.
suffixstring
Optional suffix text that comes after the content to generate. The model fills the gap between prompt and suffix.
temperaturenumber
Sampling temperature (0-2). Higher = more random. Default: 1.0.

deepseek_sessions

Управляет многоходовыми сеансами диалога. Выводит список активных сеансов, удаляет конкретный сеанс или очищает все сеансы. Сеансы хранят историю диалога для использования с параметром session_id в deepseek_chat.

Управление сессиями DeepSeek

Параметры

actionenumобязательный
Action to perform. "list": show all active sessions, "clear": remove all sessions, "delete": remove a specific session (requires session_id)
session_idstring
Session ID to delete (required when action is "delete")

Github Сайт сервера

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "@arikusi/deepseek-mcp-server"
  ],
  "env": {
    "DEEPSEEK_API_KEY": "your-api-key-here"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

FAQ

Для чего этот сервер?

Этот сервер подключает модели DeepSeek V4 к любому MCP-совместимому инструменту — Claude Code, Gemini CLI, Cursor, Windsurf. Он даёт доступ к двум моделям с окном в 1 миллион токенов, поддержкой многопоточных диалогов, вызовом функций и отслеживанием расходов. Вместо прямой работы с API ты используешь DeepSeek прямо в редакторе или терминале, как если бы это была встроенная языковая модель.

Что он умеет?

Сервер общается с моделями DeepSeek V4 через инструменты. Ведёт диалоги deepseek_chat с выбором модели, режимом рассуждений, JSON-ответами, вызовом функций, стримингом и мультимодальностью. Дописывает код между префиксом и суффиксом через deepseek_fim. Управляет сессиями через deepseek_sessions: показывает, удаляет и очищает историю разговоров. Считает стоимость запросов с учётом кэша, отдаёт ресурсы deepseek://models, deepseek://config, deepseek://usage и содержит 12 шаблонов промптов.