MCP Server

Maintained

MIT

DeepSeek MCP Server MCP Server

io.github.DMontgomery40/deepseek

Official MCP server exposing DeepSeek V4 chat, FIM completion, model listing, and balance endpoints.

What is the DeepSeek MCP Server MCP server?

DeepSeek MCP Server is a Model Context Protocol server that connects AI agents like Claude and Cursor to DeepSeek's V4 API, exposing chat completion, FIM completion, model listing, and account balance endpoints. It supports both local stdio (npx/Docker) installation with your own DeepSeek API key, and a hosted remote HTTP endpoint with bearer-token auth.

DeepSeek MCP Server gives AI coding assistants and agents (Claude Code, Cursor, Codex CLI, etc.) direct access to DeepSeek's V4 API through the Model Context Protocol. It supports chat completions (with thinking/reasoning modes, JSON output, function tools, streaming, and conversation memory), fill-in-the-middle code completion via deepseek-v4-pro, live model listing, and account balance checks. It can run locally via npx or Docker using your own DeepSeek API key, or connect to a hosted remote endpoint with bearer-token authentication.

How to install DeepSeek MCP Server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

DEEPSEEK_API_KEY
required
secret
DeepSeek API key used for upstream DeepSeek requests

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

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

Cursor

~/.cursor/mcp.json

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

Windsurf

~/.codeium/windsurf/mcp_config.json

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

VS Code

.vscode/mcp.json

{
  "servers": {
    "deepseek": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "deepseek-mcp-server"
      ],
      "env": {
        "DEEPSEEK_API_KEY": "<YOUR_DEEPSEEK_API_KEY>"
      }
    }
  }
}

Claude Code

claude mcp add deepseek --env DEEPSEEK_API_KEY=<YOUR_DEEPSEEK_API_KEY> -- npx -y deepseek-mcp-server

Tools & capabilities

Tools this server exposes to the agent.

chat_completion — DeepSeek V4 chat, defaults to deepseek-v4-flash. Supports thinking mode (enabled/disabled), reasoning_effort (high/max), JSON output, function tools, logprobs, streaming, and conversation memory.
completion — DeepSeek V4 Pro FIM (fill-in-the-middle) completion, defaults to deepseek-v4-pro.
list_models — Reads the live DeepSeek model list.
get_user_balance — Reads DeepSeek account balance and availability.
reset_conversation — Clears an in-memory conversation.
list_conversations — Lists in-memory conversation IDs.

Use cases

Add DeepSeek V4 chat capabilities (including reasoning/thinking mode) to an AI coding agent
Perform code fill-in-the-middle completions using deepseek-v4-pro
Check available DeepSeek models programmatically
Monitor DeepSeek account balance from within an agent workflow
Maintain and reset multi-turn conversation state during agent sessions

DeepSeek MCP Server MCP server FAQ

What does the DeepSeek MCP server do?

It exposes DeepSeek's V4 API (chat completions, FIM completions, model listing, and user balance) as MCP tools so agents like Claude Code and Cursor can call DeepSeek directly.

Is the DeepSeek MCP server free to use?

The server itself is open source (MIT license) and free, but you need a DeepSeek API key, and usage is billed by DeepSeek according to their API pricing/balance.

How do I install it in Cursor?

You can add it to Cursor's mcp.json pointing at the hosted remote endpoint with an Authorization bearer token header, or run it locally via `npx -y deepseek-mcp-server` with DEEPSEEK_API_KEY set and configure Cursor to use the stdio transport.

How do I install it in Claude Code?

Run `claude mcp add --transport http deepseek https://deepseek-mcp.ragweld.com/mcp --header "Authorization: Bearer $DEEPSEEK_MCP_AUTH_TOKEN"` after setting the DEEPSEEK_MCP_AUTH_TOKEN environment variable, or configure it locally via stdio with a DeepSeek API key.

What authentication does it require?

For local/stdio use it requires a DEEPSEEK_API_KEY environment variable. For the hosted remote endpoint, it requires a bearer token passed via the Authorization header (DEEPSEEK_MCP_AUTH_TOKEN).

Can I self-host this server?

Yes, it can be run locally via npx (`npx -y deepseek-mcp-server`) or via the published Docker image, using your own DeepSeek API key and optional environment configuration for base URL, timeouts, default model, and transport settings.

README (reference)

Source of truth, from the repository.

DeepSeek MCP Server

Model Context Protocol server for the current DeepSeek V4 API.

As of April 24, 2026, DeepSeek's public API reference documents:

POST /chat/completions with deepseek-v4-flash and deepseek-v4-pro
POST /beta/completions for V4 Pro FIM completion
GET /models
GET /user/balance

This server exposes only those documented API surfaces. It does not ship a V4 monitor, speculative image/video/upload tools, or automatic model substitution.

Tools

chat_completion: 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.
completion: DeepSeek V4 Pro FIM completion. Defaults to deepseek-v4-pro.
list_models: Reads the live DeepSeek model list.
get_user_balance: Reads account balance and availability.
reset_conversation: Clears an in-memory conversation.
list_conversations: Lists in-memory conversation IDs.

Hosted Remote

URL: https://deepseek-mcp.ragweld.com/mcp
Auth: Authorization: Bearer <token>

Codex CLI:

export DEEPSEEK_MCP_AUTH_TOKEN="REPLACE_WITH_TOKEN"
codex mcp add deepseek --url https://deepseek-mcp.ragweld.com/mcp --bearer-token-env-var DEEPSEEK_MCP_AUTH_TOKEN

Claude Code:

export DEEPSEEK_MCP_AUTH_TOKEN="REPLACE_WITH_TOKEN"
claude mcp add --transport http deepseek https://deepseek-mcp.ragweld.com/mcp --header "Authorization: Bearer $DEEPSEEK_MCP_AUTH_TOKEN"

Cursor:

node -e 'const fs=require("fs"),p=process.env.HOME+"/.cursor/mcp.json";let j={mcpServers:{}};try{j=JSON.parse(fs.readFileSync(p,"utf8"))}catch{};j.mcpServers={...(j.mcpServers||{}),deepseek:{url:"https://deepseek-mcp.ragweld.com/mcp",headers:{Authorization:"Bearer ${env:DEEPSEEK_MCP_AUTH_TOKEN}"}}};fs.mkdirSync(process.env.HOME+"/.cursor",{recursive:true});fs.writeFileSync(p,JSON.stringify(j,null,2));'

Local Stdio

DEEPSEEK_API_KEY="REPLACE_WITH_DEEPSEEK_KEY" npx -y deepseek-mcp-server

Docker:

docker pull docker.io/dmontgomery40/deepseek-mcp-server:0.5.0
docker run --rm -i -e DEEPSEEK_API_KEY="REPLACE_WITH_DEEPSEEK_KEY" docker.io/dmontgomery40/deepseek-mcp-server:0.5.0

Environment

Required:

DEEPSEEK_API_KEY=your-api-key

Optional:

DEEPSEEK_BASE_URL=https://api.deepseek.com
DEEPSEEK_REQUEST_TIMEOUT_MS=120000
DEEPSEEK_DEFAULT_MODEL=deepseek-v4-flash
MCP_TRANSPORT=stdio
MCP_HTTP_HOST=127.0.0.1
MCP_HTTP_PORT=3001
MCP_HTTP_PATH=/mcp
MCP_HTTP_STATEFUL_SESSION=false
CONVERSATION_MAX_MESSAGES=200

Verification

npm run build
npm test
DEEPSEEK_API_KEY="REPLACE_WITH_DEEPSEEK_KEY" npm run test:live
DEEPSEEK_MCP_AUTH_TOKEN="REPLACE_WITH_TOKEN" npm run test:remote

The live smoke test performs real DeepSeek requests for model listing, balance, non-thinking chat, thinking streaming chat with reasoning_content, FIM completion, and MCP tool calls.

Registry Identity

MCP Registry name: io.github.DMontgomery40/deepseek
npm package: deepseek-mcp-server
OCI package: docker.io/dmontgomery40/deepseek-mcp-server:0.5.0

Official References

DeepSeek chat completions: https://api-docs.deepseek.com/api/create-chat-completion
DeepSeek FIM completions: https://api-docs.deepseek.com/api/create-completion
DeepSeek models: https://api-docs.deepseek.com/api/list-models
DeepSeek balance: https://api-docs.deepseek.com/api/get-user-balance
MCP specification: https://modelcontextprotocol.io/specification/2025-11-25

License

Apache-2.0

View repository →