What can you do with this server?

This server enables advanced text generation using the Deepseek R1 or Deepseek V3 language models through the Model Context Protocol. You can: * Generate text with up to 8192 tokens in a single request * Choose between DeepSeek-R1 (deepseek-reasoner) and DeepSeek-V3 (deepseek-chat) models for different tasks * Configure parameters like max_tokens and temperature (0-2) to control output length and creativity * Integrate seamlessly with Claude Desktop * Handle various use cases including coding, data analysis, creative writing and translation * Receive detailed error messages for quick troubleshooting * Use the full MCP protocol for compatibility with other tools

How do I use Deepseek R1 MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Deepseek R1 MCP Server explain quantum entanglement in simple terms" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Deepseek R1 MCP Server

A Model Context Protocol (MCP) server implementation for the Deepseek R1 language model. Deepseek R1 is a powerful language model optimized for reasoning tasks with a context window of 8192 tokens.

Why Node.js? This implementation uses Node.js/TypeScript as it provides the most stable integration with MCP servers. The Node.js SDK offers better type safety, error handling, and compatibility with Claude Desktop.

Quick Start

Installing manually

# Clone and install
git clone https://github.com/66julienmartin/MCP-server-Deepseek_R1.git
cd deepseek-r1-mcp
npm install

# Set up environment
cp .env.example .env  # Then add your API key

# Build and run
npm run build

Related MCP server: DuckDuckGo MCP Server

Prerequisites

Node.js (v18 or higher)
npm
Claude Desktop
Deepseek API key

Model Selection

By default, this server uses the deepseek-R1 model. If you want to use DeepSeek-V3 instead, modify the model name in src/index.ts:

// For DeepSeek-R1 (default)
model: "deepseek-reasoner"

// For DeepSeek-V3
model: "deepseek-chat"

Project Structure

deepseek-r1-mcp/
├── src/
│   ├── index.ts             # Main server implementation
├── build/                   # Compiled files
│   ├── index.js
├── LICENSE
├── README.md
├── package.json
├── package-lock.json
└── tsconfig.json

Configuration

Create a .env file:

DEEPSEEK_API_KEY=your-api-key-here

Update Claude Desktop configuration:

{
  "mcpServers": {
    "deepseek_r1": {
      "command": "node",
      "args": ["/path/to/deepseek-r1-mcp/build/index.js"],
      "env": {
        "DEEPSEEK_API_KEY": "your-api-key"
      }
    }
  }
}

Development

npm run dev     # Watch mode
npm run build   # Build for production

Features

Advanced text generation with Deepseek R1 (8192 token context window)
Configurable parameters (max_tokens, temperature)
Robust error handling with detailed error messages
Full MCP protocol support
Claude Desktop integration
Support for both DeepSeek-R1 and DeepSeek-V3 models

API Usage

{
  "name": "deepseek_r1",
  "arguments": {
    "prompt": "Your prompt here",
    "max_tokens": 8192,    // Maximum tokens to generate
    "temperature": 0.2     // Controls randomness
  }
}

The Temperature Parameter

The default value of temperature is 0.2.

Deepseek recommends setting the temperature according to your specific use case:

USE CASE	TEMPERATURE	EXAMPLE
Coding / Math	0.0	Code generation, mathematical calculations
Data Cleaning / Data Analysis	1.0	Data processing tasks
General Conversation	1.3	Chat and dialogue
Translation	1.3	Language translation
Creative Writing / Poetry	1.5	Story writing, poetry generation