DeepSeek MCP Server

Model Context Protocol server for the current DeepSeek V4 API.

As of August 18, 2026, DeepSeek's public API reference documents:

• POST /chat/completions with deepseek-v4-flash and deepseek-v4-pro
• POST /responses with native OpenAI Responses API request and response shapes
• 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: "low" | "high" | "max", JSON output, function tools, logprobs, streaming, and conversation memory.
• create_response: Stateless native Responses API calls with text or structured input, reasoning effort controls, function tools, server-side web search, structured output, and semantic streaming.
• 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
MCP_HTTP_ALLOWED_ORIGINS=https://app.example.com,http://localhost:3000
CONVERSATION_MAX_MESSAGES=200

MCP_HTTP_ALLOWED_ORIGINS is only needed for browser-based clients. Streamable HTTP requests that send an Origin header are rejected with 403 unless the exact origin appears in this comma-separated allowlist; normal MCP clients that omit Origin are unaffected.

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, a native Responses API call, FIM completion, and MCP tool calls.

Protocol Compatibility

This release uses the supported @modelcontextprotocol/sdk v1 line and the 2025-era MCP initialization flow. Migrating to the split v2 packages and the 2026-07-28 protocol era is intentionally outside this maintenance update because it changes lifecycle and packaging contracts rather than being a drop-in dependency bump.

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 Responses API: https://api-docs.deepseek.com/api/create-response
• 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/2026-07-28
• MCP TypeScript SDK v2 migration guide: https://github.com/modelcontextprotocol/typescript-sdk/blob/main/docs/migration/upgrade-to-v2.md

License

MIT