# DeepSeek MCP Server

Wires DeepSeek models into your coding agent: chat with images, FIM code completion, model discovery and balance checks.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 359
- Author: DMontgomery40
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/DMontgomery40/deepseek-mcp-server
- Updated: 2026-10-19
- HTML: https://affpapa.org/en/nevibecode/mcp/deepseek-mcp-server

## What it does

The server hands your agent eleven tools. `chat_completion` covers text or visual chat with thinking controls, function tools and memory keyed by `conversation_id`. `create_response` makes stateless Responses API calls, and `completion` handles FIM through `/beta/completions`. Alongside those sit `list_models`, `get_user_balance` and four file operations: upload, list, retrieve, delete.

You need Node.js 20 or newer and a DeepSeek key in `DEEPSEEK_API_KEY`. Thinking is on by default, but forced tool choice in chat only works with thinking disabled — worth checking if your function calls quietly stop firing. FIM is beta and non-thinking, and it carries its own output limit, so the chat ceiling does not apply there.

\`create_response` keeps no history; send the full input each time. `web_search` runs server-side only with `deepseek-v4-pro`, while `deepseek-flash` ignores it. There are no standalone Search or Fetch tools here, and `MCP_TOOL_RATE_LIMIT` caps MCP invocations rather than what you spend at the provider.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `DEEPSEEK_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add deepseek -e DEEPSEEK_API_KEY=<DEEPSEEK_API_KEY> -- npx -y deepseek-mcp-server
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add deepseek-mcp-server --env DEEPSEEK_API_KEY=<DEEPSEEK_API_KEY> -- npx -y deepseek-mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "deepseek-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "deepseek-mcp-server"
            ],
            "env": {
                "DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "deepseek-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "deepseek-mcp-server"
            ],
            "env": {
                "DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e DEEPSEEK_API_KEY=<DEEPSEEK_API_KEY> deepseek-mcp-server npx -y deepseek-mcp-server
```
Replace <…> with your own values

## When to use it
- call a DeepSeek model from the agent without leaving the editor
- fill in code from the surrounding context with FIM
- upload an image once and reuse its `file_id`
- see which models the account can reach right now
- check the remaining balance before a long session

## Example prompts
- List the DeepSeek models available to my account with their context limits
- Ask deepseek-v4-pro what is wrong with this file and return the full answer
- Upload this PNG and remember the file_id for later calls

## Similar
- [langchain-dev-guide](https://affpapa.org/en/nevibecode/skills/langchain-dev-guide.md) — skill · 836 installs
- [cli-anything-novita](https://affpapa.org/en/nevibecode/skills/cli-anything-novita.md) — skill · 462 installs
- [claude-switch-models-setup](https://affpapa.org/en/nevibecode/skills/claude-switch-models-setup.md) — skill · 344 installs
- [pi-prompting](https://affpapa.org/en/nevibecode/skills/pi-prompting.md) — skill · 2900 installs
- [read](https://affpapa.org/en/nevibecode/skills/read.md) — skill · 14000 installs
- [hindsight-docs](https://affpapa.org/en/nevibecode/skills/hindsight-docs.md) — skill · 9200 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md