DeepSeek MCP Server

A small, clean Model Context Protocol server that connects any MCP client — Claude Desktop, Cursor, Cline, Cowork — to the DeepSeek API, including DeepSeek-R1 reasoning with a visible chain-of-thought.

<p align="center"><img src="demo.gif" alt="deepseek-mcp-server demo" width="760"></p>

One Python file, four tools, no framework lock-in. Bring your own DeepSeek key and you get fast V3 generation, multi-turn chat, and R1 deep reasoning that shows its work — straight from your assistant.

✨ Tools

Tool	What it does
deepseek_generate	Single-turn text with DeepSeek-V3 (system instruction, temperature, JSON mode)
deepseek_chat	Multi-turn conversation; switch to deepseek-reasoner for step-by-step thinking
deepseek_reason	Hard problems with DeepSeek-R1 — returns the reasoning trace and the answer
deepseek_list_models	List models available to your key

🚀 Quick start

Option A — one-click (Windows, Claude Desktop)

# in the repo folder, right-click install.ps1 -> "Run with PowerShell"
./install.ps1

It asks for your API key, installs dependencies, and wires up Claude Desktop. Restart Claude and you're done.

Option B — manual (any OS / any MCP client)

git clone https://github.com/deepzhun/deepseek-mcp-server.git
cd deepseek-mcp-server
pip install -r requirements.txt
export DEEPSEEK_API_KEY="your-api-key"     # Windows: setx DEEPSEEK_API_KEY "your-api-key"
python deepseek_mcp.py

Get an API key at https://platform.deepseek.com/api_keys. DeepSeek's endpoint is OpenAI-compatible.

🔌 Add to your MCP client

Copy config.example.json and drop the server block into your client config, replacing the placeholder key:

{
  "mcpServers": {
    "deepseek": {
      "command": "python",
      "args": ["/absolute/path/to/deepseek_mcp.py"],
      "env": { "DEEPSEEK_API_KEY": "YOUR_DEEPSEEK_API_KEY_HERE" }
    }
  }
}

💬 Usage examples

• "Use deepseek to draft a product update in Chinese."
• "Ask deepseek_reason to solve this logic puzzle and show its reasoning."
• "Use deepseek_chat to continue our debugging conversation."

🔐 Security

• The key is read from the DEEPSEEK_API_KEY environment variable — never hard-code it.
• config.json and .env are git-ignored so a real key can't be committed by accident.
• Rotate your key in the DeepSeek console if it is ever exposed.

🛠️ Development

pip install -r requirements.txt
python -c "import deepseek_mcp; print(deepseek_mcp.mcp.name)"   # smoke test

Single-file server (deepseek_mcp.py): typed Pydantic inputs, consistent error handling, MCP tool annotations. A sibling of gemini-mcp-server — same clean shape, different provider.

📄 License

MIT © deepzhun (深准). Contributions welcome — open an issue or PR.