DeepSeek Pi MCP

An MCP server that gives local AI agents access to DeepSeek V4 through Pi's coding-agent SDK and provider layer.

Setup

Install dependencies and build:

npm install
npm run build

Store a DeepSeek API key using Pi's credential flow (/login in Pi, selecting DeepSeek). The server intentionally reads Pi's stored deepseek credential and does not accept keys from MCP callers.

Configure approved workspaces as a JSON array of existing directories:

$env:DEEPSEEK_MCP_WORKSPACE_ROOTS = '["C:\\work\\projects"]'

If DEEPSEEK_MCP_WORKSPACE_ROOTS is unset, the server defaults to its own working directory at launch. For a global install (e.g. registered once at user scope in Claude Code), leave it unset — each MCP client spawns the server with cwd set to the calling project's directory, so the allowed workspace tracks whichever project invoked it.

Start the stdio server:

npm start

An MCP client can launch the built entrypoint directly. For example:

{
  "mcpServers": {
    "deepseek-pi": {
      "command": "node",
      "args": ["C:\\path\\to\\deepseek-pi-mcp\\dist\\index.js"],
      "env": {
        "DEEPSEEK_MCP_WORKSPACE_ROOTS": "[\"C:\\\\work\\\\projects\"]"
      }
    }
  }
}

For a custom Pi data directory, set PI_AGENT_DIR to the directory containing auth.json and models.json.

MCP tools

• deepseek_chat sends a normalized conversation to either deepseek-v4-flash or deepseek-v4-pro. The model is required on every call. Tool definitions are forwarded and returned tool calls are not executed by this server.
• start_coding_task starts an asynchronous Pi coding session in an approved workspace and returns a task ID.
• send_coding_task_message sends a new prompt to an idle task or queues steer/follow_up input while it is running.
• get_coding_task_status returns state, recent events, latest assistant text, and Pi usage/cost statistics.
• get_coding_task_result returns the same bounded transcript and final result, with resultAvailable indicating whether the task has settled.
• cancel_coding_task aborts an active task.
• close_coding_task disposes of a session and removes it from memory.

Coding sessions are resumable only while this server process is alive. Pi's read/write/edit/search and bash tools run with the server user's normal operating-system permissions; configured workspace roots constrain task selection and cwd but are not an OS sandbox.

Development

npm run typecheck
npm run build
npm test