DeepSeek MCP Server

MCP server for DeepSeek AI with chat, reasoning, 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, and LobeHub.

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:

claude mcp add --transport http deepseek \
  https://deepseek-mcp.tahirl.com/mcp \
  --header "Authorization: Bearer YOUR_DEEPSEEK_API_KEY"

Cursor / Windsurf / VS Code:

{
  "mcpServers": {
    "deepseek": {
      "url": "https://deepseek-mcp.tahirl.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DEEPSEEK_API_KEY}"
      }
    }
  }
}

Local (stdio)

Claude Code:

claude mcp add -s user deepseek npx @arikusi/deepseek-mcp-server -e DEEPSEEK_API_KEY=your-key-here

Gemini CLI:

gemini mcp add deepseek npx @arikusi/deepseek-mcp-server -e DEEPSEEK_API_KEY=your-key-here

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 V3.2: Both models now run DeepSeek-V3.2 (since Sept 2025)
• 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 thinking on deepseek-chat with thinking: {type: "enabled"}
• JSON Output Mode: Structured JSON responses with json_mode: true
• Function Calling: OpenAI-compatible tool use with up to 128 tool definitions
• 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 Dockerfi