Deepseek R1

🚀 Deepseek R1 MCP Server

This is an implementation of the Model Context Protocol (MCP) server for the Deepseek R1 language model. Deepseek R1 is a powerful language model designed for inference tasks, with a context window size of 8192 tokens.

Why Node.js?

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

🚀 Quick Start

Manual Installation

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

# Configure the environment
cp .env.example .env  # Then add your API key

# Build and run
npm run build

✨ 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 the 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 file
├── build/                   # Compiled files
│   ├── index.js
├── LICENSE
├── README.md
├── package.json
├── package-lock.json
└── tsconfig.json

🔧 Configuration

1. Create an .env file:

DEEPSEEK_API_KEY=Your API key

2. Update the 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

• Deepseek R1 with advanced text generation capabilities (8192 token context window)
• Configurable parameters (max_tokens, temperature)
• Support for the Deepseek-R1 model with a context window size of 8192
• Detailed error handling
• Support for Claude Desktop

💻 Usage Examples

Basic Usage

{
  "model": "deepseek-reasoner",
  "messages": [
    {"role": "user", "content": "Hello!"}
  ],
  "temperature": 0.7
}

🔧 Temperature Parameter

🔧 Error Handling

• Invalid input: Provide detailed error messages
• Computational limit: Requests exceeding the context window size
• Model not found: When the specified model does not exist

🤝 Contribution Guidelines

Contributions are welcome! Please refer to the project repository for how to contribute.

📄 License

MIT