deepseek-mcp-server

# DeepSeek MCP Server

> MCP server integrating DeepSeek V4 models (deepseek-v4-flash and deepseek-v4-pro, 1M context) with Claude Code, Gemini CLI, and other MCP clients. deepseek-chat and deepseek-reasoner are deprecated aliases, still accepted and resolved to v4-flash. Hosted remote endpoint at deepseek-mcp.tahirl.com/mcp (BYOK, Bring Your Own Key). Stdio and HTTP transports, Docker deployment, multi-turn sessions, model fallback with circuit breaker, MCP Resources, thinking mode, JSON output, schema-validated JSON output (response_schema), function calling, fill-in-the-middle (FIM) completion, multimodal content support, model-aware cost tracking, 12 prompt templates.

## Docs

- [README](https://github.com/arikusi/deepseek-mcp-server#readme): Installation, quick start, configuration, usage examples
- [API Reference](https://github.com/arikusi/deepseek-mcp-server#available-tools): deepseek_chat tool parameters and response format
- [Session Management](https://github.com/arikusi/deepseek-mcp-server#multi-turn-session-example): Multi-turn conversations via session_id
- [Model Fallback](https://github.com/arikusi/deepseek-mcp-server#model-fallback--circuit-breaker): Automatic fallback with circuit breaker resilience
- [MCP Resources](https://github.com/arikusi/deepseek-mcp-server#available-resources): deepseek://models, deepseek://config, deepseek://usage
- [Thinking Mode](https://github.com/arikusi/deepseek-mcp-server#thinking-mode-example): Enable thinking mode with thinking parameter
- [JSON Mode](https://github.com/arikusi/deepseek-mcp-server#json-output-mode-example): Structured JSON output mode
- [Schema-Validated JSON](https://github.com/arikusi/deepseek-mcp-server#deepseek_chat): response_schema parameter validates output against a JSON Schema, with bounded repair retries and a ReDoS guard on schema patterns
- [Function Calling](https://github.com/arikusi/deepseek-mcp-server#function-calling-example): Tool definitions, tool_choice, tool result messages
- [FIM Completion](https://github.com/arikusi/deepseek-mcp-server#deepseek_fim): Fill-in-the-middle code and content completion via deepseek_fim (prompt + suffix)
- [Prompt Templates](https://github.com/arikusi/deepseek-mcp-server#available-prompts): 12 prompts for debugging, code review, research
- [Remote Endpoint](https://github.com/arikusi/deepseek-mcp-server#remote-endpoint-hosted): Hosted BYOK endpoint at deepseek-mcp.tahirl.com/mcp (Cloudflare Workers)
- [HTTP Transport](https://github.com/arikusi/deepseek-mcp-server#http-transport-self-hosted): Self-hosted remote access via Streamable HTTP transport (loopback by default, optional bearer-token auth)
- [Docker](https://github.com/arikusi/deepseek-mcp-server#docker): Containerized deployment with health checks
- [Configuration](https://github.com/arikusi/deepseek-mcp-server#configuration): Environment variables (API key, sessions, fallback, timeout, transport)
- [Changelog](https://github.com/arikusi/deepseek-mcp-server/blob/main/CHANGELOG.md): Version history and release notes
- [Full Documentation](https://github.com/arikusi/deepseek-mcp-server/blob/main/llms-full.txt): Complete docs in single file for LLM context