DeepSeek MCP Server

Name: DeepSeek MCP Server
Author: DMontgomery40

@DMontgomery40

Repository Homepage

About DeepSeek MCP Server

Model Context Protocol server for DeepSeek's advanced language models

#mcp #r1 #deepseek-chat #deepseek-api #model-context-protocol #deepseek-v3 #deepseek-r1

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "deepseek-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "deepseek-mcp-server"
      ],
      "env": {
        "DEEPSEEK_API_KEY": "REPLACE_WITH_DEEPSEEK_KEY"
      }
    }
  }
}

Tools

DeepSeek V4 chat. Defaults to `deepseek-v4-flash`. Supports `thinking: { "type": "enabled" | "disabled" }`, `reasoning_effort: "high" | "max"`, JSON output, function tools, logprobs, streaming, and conversation memory.

DeepSeek V4 Pro FIM completion. Defaults to `deepseek-v4-pro`.

Reads the live DeepSeek model list.

Reads account balance and availability.

Clears an in-memory conversation.

Lists in-memory conversation IDs.

Overview

What is DeepSeek MCP Server?

A Model Context Protocol server that exposes DeepSeek’s V4 API (chat completions, FIM completions, model listing, account balance) as MCP tools. Designed for developers using MCP-compatible hosts like Claude Code, Cursor, or Codex CLI.

How to use DeepSeek MCP Server?

Run locally via npx deepseek-mcp-server or Docker, setting the DEEPSEEK_API_KEY environment variable. Alternatively, connect to the hosted remote at https://deepseek-mcp.ragweld.com/mcp using a bearer token. Transport is stdio by default; HTTP can be configured via environment variables.

Key features of DeepSeek MCP Server

Chat completions with deepseek-v4-flash and deepseek-v4-pro
FIM (fill-in‑the‑middle) completion with deepseek-v4-pro
List models and check account balance
In‑memory conversation history with reset and list tools
Supports streaming, thinking, reasoning effort, JSON output, and function tools
Official MCP Registry listing and OCI container image

Use cases of DeepSeek MCP Server

Integrate DeepSeek V4 chat into a Claude Code or Cursor workflow
Automate FIM completions for code generation within MCP agents
Monitor account usage and available models programmatically
Build custom AI tools that rely on DeepSeek’s latest API

FAQ from DeepSeek MCP Server

What tools does DeepSeek MCP Server expose?

It provides chat_completion, completion, list_models, get_user_balance, reset_conversation, and list_conversations. Only documented DeepSeek V4 API endpoints are supported.

How do I authenticate when using the hosted remote?

Set the environment variable DEEPSEEK_MCP_AUTH_TOKEN and pass it as a bearer token in the Authorization header. For local usage, set DEEPSEEK_API_KEY.

What runtime and environment variables are required?

Requires Node.js (to run via npx) and the DEEPSEEK_API_KEY environment variable. Optional variables include DEEPSEEK_BASE_URL, DEEPSEEK_REQUEST_TIMEOUT_MS, MCP_TRANSPORT, and CONVERSATION_MAX_MESSAGES.

Where is conversation data stored?

Conversation history is held in memory on the server. Use reset_conversation or list_conversations to manage it.

Does the server support image, video, or upload tools?

No. The server explicitly states it does not ship speculative image, video, or upload tools, nor automatic model substitution. Only documented chat, FIM, model listing, and balance endpoints are exposed.