$git clone https://github.com/DMontgomery40/deepseek-mcp-serverModel Context Protocol server for the current DeepSeek V4 API.
| 1 | # DeepSeek MCP Server |
| 2 | |
| 3 | <p align="center"> |
| 4 | <a href="https://github.com/deepseek-ai/awesome-deepseek-integration"><img alt="DeepSeek Official List" src="https://img.shields.io/badge/DeepSeek%20Official%20List-Linked-0A66FF?logo=github&logoColor=white" /></a> |
| 5 | <a href="https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.DMontgomery40/deepseek"><img alt="Official MCP Registry" src="https://img.shields.io/badge/MCP%20Registry-Official%20Active-0A66FF" /></a> |
| 6 | <a href="https://www.npmjs.com/package/deepseek-mcp-server"><img alt="npm version" src="https://img.shields.io/npm/v/deepseek-mcp-server?logo=npm" /></a> |
| 7 | <a href="https://www.npmjs.com/package/deepseek-mcp-server"><img alt="npm downloads" src="https://img.shields.io/npm/dm/deepseek-mcp-server?logo=npm" /></a> |
| 8 | <a href="https://github.com/DMontgomery40/deepseek-mcp-server/blob/main/server.json"><img alt="OCI package" src="https://img.shields.io/badge/OCI-docker.io%2Fdmontgomery40%2Fdeepseek--mcp--server%3A0.5.0-2496ED?logo=docker&logoColor=white" /></a> |
| 9 | <a href="https://github.com/DMontgomery40/deepseek-mcp-server"><img alt="GitHub stars" src="https://img.shields.io/github/stars/DMontgomery40/deepseek-mcp-server?logo=github" /></a> |
| 10 | <a href="https://glama.ai/mcp/servers/asht4rqltn"><img alt="Glama MCP Listing" src="https://img.shields.io/badge/Glama-MCP%20Listing-7B61FF" /></a> |
| 11 | <a href="https://spark.entire.vc/assets/vb-deepseek-mcp-server?utm_source=github&utm_medium=readme"><img alt="Listed on Spark" src="https://spark.entire.vc/badges/listed.svg" /></a> |
| 12 | <a href="https://spark.entire.vc/assets/vb-deepseek-mcp-server?utm_source=github&utm_medium=readme"><img alt="Install via Spark" src="https://spark.entire.vc/badges/vb-deepseek-mcp-server/install.svg" /></a> |
| 13 | </p> |
| 14 | |
| 15 | Model Context Protocol server for the current DeepSeek V4 API. |
| 16 | |
| 17 | As of April 24, 2026, DeepSeek's public API reference documents: |
| 18 | |
| 19 | - `POST /chat/completions` with `deepseek-v4-flash` and `deepseek-v4-pro` |
| 20 | - `POST /beta/completions` for V4 Pro FIM completion |
| 21 | - `GET /models` |
| 22 | - `GET /user/balance` |
| 23 | |
| 24 | This server exposes only those documented API surfaces. It does not ship a V4 monitor, speculative image/video/upload tools, or automatic model substitution. |
| 25 | |
| 26 | ## Tools |
| 27 | |
| 28 | - `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. |
| 29 | - `completion`: DeepSeek V4 Pro FIM completion. Defaults to `deepseek-v4-pro`. |
| 30 | - `list_models`: Reads the live DeepSeek model list. |
| 31 | - `get_user_balance`: Reads account balance and availability. |
| 32 | - `reset_conversation`: Clears an in-memory conversation. |
| 33 | - `list_conversations`: Lists in-memory conversation IDs. |
| 34 | |
| 35 | ## Hosted Remote |
| 36 | |
| 37 | - URL: `https://deepseek-mcp.ragweld.com/mcp` |
| 38 | - Auth: `Authorization: Bearer <token>` |
| 39 | |
| 40 | Codex CLI: |
| 41 | |
| 42 | ```bash |
| 43 | export DEEPSEEK_MCP_AUTH_TOKEN="REPLACE_WITH_TOKEN" |
| 44 | codex mcp add deepseek --url https://deepseek-mcp.ragweld.com/mcp --bearer-token-env-var DEEPSEEK_MCP_AUTH_TOKEN |
| 45 | ``` |
| 46 | |
| 47 | Claude Code: |
| 48 | |
| 49 | ```bash |
| 50 | export DEEPSEEK_MCP_AUTH_TOKEN="REPLACE_WITH_TOKEN" |
| 51 | claude mcp add --transport http deepseek https://deepseek-mcp.ragweld.com/mcp --header "Authorization: Bearer $DEEPSEEK_MCP_AUTH_TOKEN" |
| 52 | ``` |
| 53 | |
| 54 | Cursor: |
| 55 | |
| 56 | ```bash |
| 57 | 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));' |
| 58 | ``` |
| 59 | |
| 60 | ## Local Stdio |
| 61 | |
| 62 | ```bash |
| 63 | DEEPSEEK_API_KEY="REPLACE_WITH_DEEPSEEK_KEY" npx -y deepseek-mcp-server |
| 64 | ``` |
| 65 | |
| 66 | Docker: |
| 67 | |
| 68 | ```bash |
| 69 | docker pull docker.io/dmontgomery40/deepseek-mcp-server:0.5.0 |
| 70 | docker run --rm -i -e DEEPSEEK_API_KEY="REPLACE_WITH_DEEPSEEK_KEY" docker.io/dmontgomery |