# Deepseek

> Deepseek is an open-source MCP server for ai models and llm tooling. DeepSeek chat, reasoning and sessions for MCP clients, with cost tracking. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Website:** https://mcp.tahirl.com
- **Repository:** https://github.com/arikusi/deepseek-mcp-server
- **MCP Registry name:** io.github.arikusi/deepseek
- **Categories:** AI models and LLM tooling
- **Listing updated:** 2026-11-15

## About

This server puts DeepSeek models behind MCP so clients such as Claude Code, Gemini CLI, Cursor and Windsurf can call them. The README lists deepseek-flash (the V4.1 Flash default) and deepseek-v4-pro, both with a 1M-token context window and optional chain-of-thought thinking. Older names such as deepseek-chat and deepseek-reasoner are still accepted and sent as deepseek-flash.

Beyond plain chat it adds multi-turn sessions via a session_id, model fallback with a circuit breaker, JSON output with optional schema validation and bounded repair retries, and OpenAI-style function calling with up to 128 tool definitions. A deepseek_fim tool handles fill-in-the-middle completion, and deepseek_sessions lists, deletes and clears sessions. Cost tracking separates cache hits from misses and prices each request at the peak or off-peak rate that applied.

You bring your own DeepSeek API key. Run it locally over stdio with npx, or use the hosted streamable-HTTP endpoint at deepseek-mcp.tahirl.com, which takes the key as a Bearer token. It can also be self-hosted in Docker. The README reports 368 tests with about 92% line coverage.

## Features

- **Two DeepSeek models:** deepseek-flash and deepseek-v4-pro, each with a 1M-token context and optional thinking mode.
- **Multi-turn sessions:** Context persists across calls through a session_id, with a tool to list, delete and clear sessions.
- **Fallback and circuit breaker:** Falls back between models and guards against cascading failures.
- **Schema-validated JSON:** A response_schema is checked against the output, with bounded repair retries.
- **Function calling:** OpenAI-compatible tool use with up to 128 tool definitions.
- **Fill-in-the-middle:** The deepseek_fim tool completes code or text between a prefix and suffix.
- **Peak-aware cost tracking:** Reports cache hit and miss costs at the peak or off-peak rate in effect.

## Good for

- Call DeepSeek reasoning from inside Claude Code or Cursor
- Run multi-turn chats that keep context across requests
- Get JSON output validated against a schema
- Complete code between a prefix and a suffix
- Track what each DeepSeek request costs

## Install

### Claude Code (Terminal)

```sh
claude mcp add deepseek --env DEEPSEEK_API_KEY='<DEEPSEEK_API_KEY>' -- npx -y @arikusi/deepseek-mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "deepseek": {
      "command": "npx",
      "args": [
        "-y",
        "@arikusi/deepseek-mcp-server"
      ],
      "env": {
        "DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "deepseek": {
      "command": "npx",
      "args": [
        "-y",
        "@arikusi/deepseek-mcp-server"
      ],
      "env": {
        "DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "deepseek": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@arikusi/deepseek-mcp-server"
      ],
      "env": {
        "DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "deepseek": {
      "command": "npx",
      "args": [
        "-y",
        "@arikusi/deepseek-mcp-server"
      ],
      "env": {
        "DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "deepseek": {
      "command": "npx",
      "args": [
        "-y",
        "@arikusi/deepseek-mcp-server"
      ],
      "env": {
        "DEEPSEEK_API_KEY": "<DEEPSEEK_API_KEY>"
      }
    }
  }
}
```

## Tools

- `deepseek_fim`: Fill-in-the-middle completion between a prefix and suffix.
- `deepseek_sessions`: List, delete and clear conversation sessions.

## FAQ

### Do I need a DeepSeek API key?

Yes. It is required for both the local npm package and the hosted endpoint, where it is sent as a Bearer token.

### Can I use it without installing anything?

Yes, through the hosted streamable-HTTP endpoint at https://deepseek-mcp.tahirl.com/mcp with your own key.

### Which models does it use by default?

deepseek-flash is the default, next to deepseek-v4-pro.

### Does it support images?

The README calls it multimodal ready: text and image content parts can be enabled with ENABLE_MULTIMODAL=true.

### Is Deepseek free?

Yes. Deepseek is open source, so you can use and self-host it for free.

### How do I add Deepseek to Claude Code?

Run this command in your terminal: claude mcp add deepseek --env DEEPSEEK_API_KEY='<DEEPSEEK_API_KEY>' -- npx -y @arikusi/deepseek-mcp-server

### What are the best alternatives to Deepseek?

The closest alternatives to Deepseek are Claude Code Ultimate Guide, signafAIde, Toolkien, Lugh and HypePaper.

## Alternatives

- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [signafAIde](https://ai-powered.com/mcp/signafaide): signafAIde is a freemium MCP server for security.
- [Toolkien](https://ai-powered.com/mcp/toolkien): Toolkien is an open-source MCP server for ai models and llm tooling.
- [Lugh](https://ai-powered.com/mcp/lugh): Lugh is an open-source MCP server for ai models and llm tooling.
- [HypePaper](https://ai-powered.com/mcp/hypepaper): HypePaper is a freemium MCP server for ai models and llm tooling.
- [Agent Data Tools: Compact (find, describe, run)](https://ai-powered.com/mcp/agent-data-tools-compact-find-describe-run): Agent Data Tools: Compact (find, describe, run) is a freemium MCP server for developer tools.
- [Angel Agent Guard: pre-purchase check + prompt-injection scan](https://ai-powered.com/mcp/angel-agent-guard-pre-purchase-check-prompt-injection-scan): Angel Agent Guard: pre-purchase check + prompt-injection scan is a freemium MCP server for ai models and llm tooling.
- [Mizan Calibration](https://ai-powered.com/mcp/mizan-calibration): Mizan Calibration is a free MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/deepseek
