Speciale

MCP server for DeepSeek-V3.2-Speciale, a powerful reasoning model.

Features

• Deep reasoning for complex math, code analysis, logical problems
• File references: @path syntax for files and directories
• Grep search: @grep:pattern syntax using ripgrep/grep
• Multi-turn conversations with persistence
• Local storage in DuckDB (~/.speciale/conversations.db)

Installation

Download from GitHub Releases

Download the latest binary for your platform from Releases:

# Example for macOS Apple Silicon
curl -L https://github.com/Cupnfish/speciale/releases/latest/download/speciale-darwin-aarch64 -o speciale
chmod +x speciale
sudo mv speciale /usr/local/bin/

Build from source

cargo install --git https://github.com/Cupnfish/speciale.git

Configuration

Set your DeepSeek API key:

export DEEPSEEK_API_KEY="your-api-key"

MCP Client Setup

Claude Code (CLI)

The easiest way - automatically uses current directory:

macOS/Linux:

claude mcp add speciale -e DEEPSEEK_API_KEY=your-api-key -- speciale --pwd $(pwd)

Windows (PowerShell):

claude mcp add speciale -e DEEPSEEK_API_KEY=your-api-key -- speciale --pwd $PWD

Windows (CMD):

claude mcp add speciale -e DEEPSEEK_API_KEY=your-api-key -- speciale --pwd %cd%

Claude Code (Config File)

Edit ~/.claude.json:

macOS/Linux:

{
  "mcpServers": {
    "speciale": {
      "command": "bash",
      "args": ["-c", "speciale --pwd \"$PWD\""],
      "env": {
        "DEEPSEEK_API_KEY": "your-api-key"
      }
    }
  }
}

Windows:

{
  "mcpServers": {
    "speciale": {
      "command": "cmd",
      "args": ["/c", "speciale --pwd %cd%"],
      "env": {
        "DEEPSEEK_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

Edit ~/.cursor/mcp.json:

macOS/Linux:

{
  "mcpServers": {
    "speciale": {
      "command": "bash",
      "args": ["-c", "speciale --pwd \"$PWD\""],
      "env": {
        "DEEPSEEK_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Desktop

Config locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "speciale": {
      "command": "speciale",
      "args": ["--pwd", "/path/to/your/project"],
      "env": {
        "DEEPSEEK_API_KEY": "your-api-key"
      }
    }
  }
}

Note: Claude Desktop doesn't support dynamic PWD injection. Specify the project path directly.

Reference Syntax

Examples:

Review @src/main.rs for bugs
Analyze all code in @src/
Find usages of @grep:async_fn
Search in Rust files @grep:impl:*.rs

Tip: Only use @ syntax when entire file content is needed. For small snippets, include them directly in your question.

Tool: ask_speciale

Parameters

Response

{
  "answer": "Response",
  "reasoning": "If requested",
  "conversation_id": "uuid",
  "context_tokens": 1234,
  "max_context_tokens": 131072,
  "tip": "Usage info"
}

Important

This model has NO external access and CANNOT call tools. It can only reason based on what you provide.

License

MIT

Links

• GitHub
• Releases
• DeepSeek API
• MCP Protocol