arikusi/deepseek-mcp-server

MCP server for DeepSeek V4 (v4-flash and v4-pro, 1M context) with multi-turn sessions, function calling, thinking mode, and cost tracking.
Compatible with Claude Code, Gemini CLI, Cursor, Windsurf, and any MCP-compatible client.
Officially listed on the MCP Registry , Smithery , Glama , LobeHub , and Fronteir AI .
> **v2.0.0 runs on DeepSeek V4.** Two models, deepseek-v4-flash (fast and economical) and deepseek-v4-pro (top capability), both with a 1M-token context window and optional chain-of-thought thinking. Existing deepseek-chat and deepseek-reasoner setups keep working through deprecated aliases, so upgrading is drop-in, but new setups should use the V4 names.
Quick Start
Remote (No Install)
Use the hosted endpoint directly — no npm install, no Node.js required. Bring your own DeepSeek API key:
**Claude Code:**
**Cursor / Windsurf / VS Code:**
Local (stdio)
**Claude Code:**
**Gemini CLI:**
**Scope options** (Claude Code):
- -s user: Available in all your projects (recommended)
- -s local: Only in current project (default)
- -s project: Project-specific .mcp.json file
**Get your API key:** https://platform.deepseek.com
---
Features
- **DeepSeek V4**: deepseek-v4-flash and deepseek-v4-pro, both with 1M context and optional chain-of-thought thinking mode
- **Multi-Turn Sessions**: Conversation context preserved across requests via session_id parameter
- **Model Fallback & Circuit Breaker**: Automatic fallback between models with circuit breaker protection against cascading failures
- **MCP Resources**: deepseek://models, deepseek://config, deepseek://usage — query model info, config, and usage stats
- **Thinking Mode**: Enable chain-of-thought reasoning on either V4 model with thinking: {type: "enabled"}
- **JSON Output Mode**: Structured JSON responses with json_mode: true
- **Schema-Validated JSON**: Pass a response_schema and the server validates the output against it, with bounded repair retries and a ReDoS guard on schema patterns
- **Function Calling**: OpenAI-compatible tool use with up to 128 tool definitions
- **Fill-in-the-Middle (FIM)**: Code and content completion between a prefix and suffix via the deepseek_fim tool
- **Cache-Aware Cost Tracking**: Automatic cost calculation with cache hit/miss breakdown
- **Session Management Tool**: List, delete, and clear sessions via deepseek_sessions tool
- **Configurable**: Environment-based configuration with validation
- **12 Prompt Templates**: Templates for debugging, code review, function calling, and more
- **Streaming Support**: Real-time response generation
- **Multimodal Ready**: Content part types for text + image input (enable with ENABLE_MULTIMODAL=true)
- **Remote Endpoint**: Hosted at deepseek-mcp.tahirl.com/mcp — BYOK (Bring Your Own Key), no install needed
- **HTTP Transport**: Self-hosted remote access via Streamable HTTP with TRANSPORT=http
- **Docker Ready**: Multi-stage Dockerfile with health checks for containerized deployment
- **Tested**: 340 tests, ~92% line coverage
- **Type-Safe**: Full TypeScript implementation
- **MCP Compatible**: Works with any MCP-compatible CLI (Claude Code, Gemini CLI, etc.)
Installation
Prerequisites
- Node.js 22+
- A DeepSeek API key (get one at https://platform.deepseek.com)
Manual Installation
If you prefer to install manually:
From Source
1. **Clone the repository**
2. **Install dependencies**
3. **Build the project**
Usage
Once configured, your MCP client will have access to deepseek_chat, deepseek_fim, and deepseek_sessions tools, plus 3 MCP resources.
**Example prompts:**
Your MCP client will automatically call the deepseek_chat tool.
Manual Configuration (Advanced)
If your MCP client doesn't support the add command, manually add to your config file:
**Config file locations:**
- **Claude Code**: ~/.claude.json (add to projects["your-project-path"].mcpServers section)
- **Other MCP clients**: Check your client's documentation for config file location
Available Tools
deepseek_chat