Deepseek R1

Servidor MCP Deepseek R1

Uma implementação de servidor Model Context Protocol (MCP) para o modelo de linguagem Deepseek R1. O Deepseek R1 é um modelo de linguagem poderoso otimizado para tarefas de raciocínio, com uma janela de contexto de 8192 tokens.

Por que Node.js? Esta implementação usa Node.js/TypeScript, pois oferece a integração mais estável com servidores MCP. O SDK Node.js oferece melhor segurança de tipos, tratamento de erros e compatibilidade com o Claude Desktop.

Início Rápido

Instalação manual

# 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

Pré-requisitos

• Node.js (v18 ou superior)
• npm
• Claude Desktop
• Chave de API Deepseek

Seleção de Modelo

Por padrão, este servidor usa o modelo deepseek-R1. Se você quiser usar DeepSeek-V3 em vez disso, modifique o nome do modelo em src/index.ts:

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

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

Estrutura do Projeto

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

Configuração

1. Crie um arquivo .env:

DEEPSEEK_API_KEY=your-api-key-here

2. Atualize a configuração do Claude Desktop:

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

Desenvolvimento

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

Recursos

• Geração avançada de texto com Deepseek R1 (janela de contexto de 8192 tokens)
• Parâmetros configuráveis (max_tokens, temperature)
• Tratamento robusto de erros com mensagens de erro detalhadas
• Suporte completo ao protocolo MCP
• Integração com Claude Desktop
• Suporte para os modelos DeepSeek-R1 e DeepSeek-V3

Uso da API

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

O Parâmetro de Temperatura

O valor padrão de temperature é 0.2.

A Deepseek recomenda definir o temperature de acordo com seu caso de uso específico:

CASO DE USO	TEMPERATURA	EXEMPLO
Codificação / Matemática	0.0	Geração de código, cálculos matemáticos
Limpeza de Dados / Análise de Dados	1.0	Tarefas de processamento de dados
Conversa Geral	1.3	Chat e diálogo
Tradução	1.3	Tradução de idiomas
Escrita Criativa / Poesia	1.5	Escrita de histórias, geração de poesia

Tratamento de Erros

O servidor fornece mensagens de erro detalhadas para problemas comuns:

• Erros de autenticação da API
• Parâmetros inválidos
• Limitação de taxa
• Problemas de rede

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Licença

MIT