DeepSeek MCP Server

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.