DeepSeek Subagent MCP Server

MCP server that lets Codex (or any MCP client) delegate sub-tasks to DeepSeek as a sub-agent. Single tool deepseek_task: give it a task (+ optional context), get back DeepSeek's final answer.

Features

• 🧠 Single tool deepseek_task — delegate independent work (research/draft/review/refactor/analysis)
• 💰 Defaults to deepseek-v4-flash (cost-effective), switch to deepseek-v4-pro via env
• 🔍 Surfaces reasoning_content (V4 thinking mode) as a <thinking> block
• ⚡ Zero non-MCP dependencies, one-line npx deploy

Requirements

• Node.js >= 18
• A DeepSeek API key: https://platform.deepseek.com

Install & run

cd deepseek-subagent-mcp-server
npm install
npm start

Environment variables

| Variable | Required | Default | Description | |---|---|---|---| | DEEPSEEK_API_KEY | ✅ | — | Your DeepSeek API key. | | DEEPSEEK_MODEL | | deepseek-v4-flash | Model. Also deepseek-v4-pro. | | DEEPSEEK_BASE_URL | | https://api.deepseek.com | Override endpoint (for proxies). | | DEEPSEEK_MAX_TOKENS | | 8192 | Default max output tokens. |

Codex config

Add to Codex's MCP configuration:

{
  "mcpServers": {
    "deepseek-subagent": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "deepseek-subagent-mcp-server"],
      "env": {
        "DEEPSEEK_API_KEY": "your-deepseek-api-key",
        "DEEPSEEK_MODEL": "deepseek-v4-flash"
      }
    }
  }
}

Or run from a local checkout:

{
  "mcpServers": {
    "deepseek-subagent": {
      "command": "node",
      "args": ["D:\\GitHub\\MCP\\deepseek-subagent-mcp-server\\src\\index.js"],
      "env": {
        "DEEPSEEK_API_KEY": "your-key-here"
      }
    }
  }
}

Tool: deepseek_task

| Parameter | Type | Required | Description | |---|---|---|---| | task | string | ✅ | The sub-task for DeepSeek. Be specific about what to do and output format. | | context | string | | Optional context material (code, notes, snippets). | | system | string | | Optional custom system prompt (defaults to a subagent persona). | | max_tokens | number | | Max output tokens. Default 8192. | | temperature | number | | 0-2. Omit to use model default. |

Example usage

# Delegate a code review
deepseek_task(task="Review this function for bugs and edge cases", context="<code>...")

# Delegate a research task
deepseek_task(task="Summarize the key risks of a subscription pricing model")

Related projects

• minimax-vision-mcp-server
• kimi-vision-mcp-server
• doubao-vision-mcp-server
• glm-vision-mcp-server
• qwen-vision-mcp-server

License

MIT