DMontgomery40/deepseek-mcp-server

Local stdio: DEEPSEEK_API_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="..." docker.io/dmontgomery40/deepseek-mcp-server:0.5.0
Hosted remote: claude mcp add --transport http deepseek https://deepseek-mcp.ragweld.com/mcp --header "Authorization: Bearer $DEEPSEEK_MCP_AUTH_TOKEN"
Codex CLI: codex mcp add deepseek --url https://deepseek-mcp.ragweld.com/mcp --bearer-token-env-var DEEPSEEK_MCP_AUTH_TOKEN

Usage

• •Set the required DEEPSEEK_API_KEY env var (or DEEPSEEK_MCP_AUTH_TOKEN for the hosted remote)
• •Tools: chat_completion (defaults to deepseek-v4-flash; supports thinking enabled/disabled, reasoning_effort high/max, JSON output, function tools, logprobs, streaming, conversation memory), completion (V4 Pro FIM, defaults to deepseek-v4-pro), list_models, get_user_balance, reset_conversation, list_conversations
• •Optional env: DEEPSEEK_BASE_URL, DEEPSEEK_DEFAULT_MODEL, DEEPSEEK_REQUEST_TIMEOUT_MS, MCP_TRANSPORT (stdio/http), MCP_HTTP_HOST/PORT/PATH, CONVERSATION_MAX_MESSAGES

Key features

• ✓Chat completion with thinking toggles, reasoning_effort, JSON output, function tools, logprobs, streaming, and in-memory conversation state
• ✓V4 Pro FIM completion tool (POST /beta/completions)
• ✓Live model list and account balance tools
• ✓Hosted remote endpoint at https://deepseek-mcp.ragweld.com/mcp with Bearer auth
• ✓Official MCP registry identity: io.github.DMontgomery40/deepseek; OCI package on docker.io
• ✓Live smoke test performs real DeepSeek requests (model listing, balance, non-thinking + thinking chat, FIM, MCP tool calls)

Caveats

• ⚠Exposes only the documented DeepSeek API surfaces — no V4 monitor, speculative image/video/upload tools, or automatic model substitution
• ⚠Requires a DeepSeek API key (DEEPSEEK_API_KEY) or remote bearer token
• ⚠Conversation memory is in-memory only (reset_conversation / list_conversations are the only management tools)