← Back to directory
D

DeepSeek MCP Server

Community
Community MCP server for DeepSeek V4 with chat, reasoning, function calling, and cost tracking.
GitHub source repository ↗
★ 17 Stars Category · Dev Tools Popular
63FMRS · C

A feature-rich, well-documented community MCP server for DeepSeek with dual V4 models, session management, schema-validated JSON, cost tracking, and circuit-breaker fallback, backed by ~89% test coverage. Ideal for developers integrating DeepSeek into MCP workflows, though note it is unofficial and self-hosted HTTP mode requires careful endpoint security.

Reliability
9/20
Security and permissions
13/20
Maintenance
11/20
Documentation
17/20
Setup experience
13/20
Read the FMRS scoring method →

DeepSeek MCP Server is a community-maintained, MIT-licensed MCP server for accessing DeepSeek V4 models (deepseek-v4-flash and deepseek-v4-pro), both with a 1M-token context window and optional chain-of-thought thinking mode. It provides multi-turn sessions, function calling (up to 128 tool definitions), JSON output with schema validation, fill-in-the-middle (FIM) completion, cache-aware cost tracking, automatic model fallback with circuit breaker protection, 12 prompt templates, and 3 MCP resources (models, config, usage). It runs via npm (stdio) or a hosted BYOK endpoint (Streamable HTTP), and works with Claude Code, Gemini CLI, Cursor, Windsurf, and other MCP clients. Note: this is an independent community project, not an official DeepSeek product.

Tools

deepseek_chat
Chat with DeepSeek models with function calling, thinking mode, JSON output, schema validation, multi-turn sessions, and automatic cost tracking.
deepseek_fim
Fill-in-the-Middle completion: given a prefix and optional suffix, the model completes the text in between, built for code completion and content infilling.
deepseek_sessions
Manage conversation sessions: list, delete, or clear multi-turn sessions.

Setup

Requires Node.js 20+ and a DeepSeek API key (from platform.deepseek.com). Claude Code local: 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. Or use the hosted endpoint (no install): claude mcp add --transport http deepseek https://deepseek-mcp.tahirl.com/mcp --header "Authorization: Bearer YOUR_DEEPSEEK_API_KEY".

claude_desktop_config.json
{"mcpServers":{"deepseek":{"command":"npx","args":["@arikusi/deepseek-mcp-server"],"env":{"DEEPSEEK_API_KEY":"your-api-key-here"}}}}

Fit and risk

Best for

  • Developers using MCP clients such as Claude Code, Gemini CLI, Cursor, or Windsurf
  • Users who want DeepSeek V4 models inside their local agent tooling
  • Teams that need cost tracking and usage statistics
  • Users wanting a hosted BYOK endpoint with no installation

Not for

  • Users seeking official DeepSeek support channels (this is community-maintained)
  • Users without a DeepSeek API key
  • Users needing other LLM providers such as OpenAI or Anthropic

Required permissions

  • DEEPSEEK_API_KEY environment variable (secret) is required
  • API usage costs billed via your DeepSeek API key
  • Self-hosted HTTP mode requires an open network port (binds 127.0.0.1 by default)

Risks and side effects

  • If the HTTP endpoint is exposed, anyone who can reach POST /mcp can spend your API key; set HTTP_AUTH_TOKEN when binding 0.0.0.0
  • Thinking mode can exceed 30 seconds and client tool-call timeouts may interrupt long requests
  • Costs accrue per request and grow with usage
  • Deprecated model aliases deepseek-chat/deepseek-reasoner will be removed in the next major release

Troubleshooting

  1. DEEPSEEK_API_KEY not set: ensure the add command includes the -e flag or add the key in your config file's env section
  2. Failed to connect to DeepSeek API: check key validity, internet connection, and status.deepseek.com
  3. Server not appearing in your MCP client: verify the dist/index.js path, run npm run build, and fully restart the client
  4. Permission denied on macOS/Linux: run chmod +x dist/index.js

Use cases

Complex reasoning and math proofs with deepseek-v4-pro
Step-by-step debugging and code review with thinking mode
Schema-validated structured JSON output
Code completion via fill-in-the-middle
Multi-turn conversations with cost tracking

Supported clients

Claude CodeFull support
Gemini CLIFull support
CursorFull support
WindsurfFull support
VS CodeFull support