{
  "markdown": "# DeepSeek MCP Server\n\n<p align=\"center\">\n  <a href=\"https://github.com/deepseek-ai/awesome-deepseek-integration\"><img alt=\"DeepSeek Official List\" src=\"https://img.shields.io/badge/DeepSeek%20Official%20List-Linked-0A66FF?logo=github&logoColor=white\" /></a>\n  <a href=\"https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.DMontgomery40/deepseek\"><img alt=\"Official MCP Registry\" src=\"https://img.shields.io/badge/MCP%20Registry-Official%20Active-0A66FF\" /></a>\n  <a href=\"https://www.npmjs.com/package/deepseek-mcp-server\"><img alt=\"npm version\" src=\"https://img.shields.io/npm/v/deepseek-mcp-server?logo=npm\" /></a>\n  <a href=\"https://www.npmjs.com/package/deepseek-mcp-server\"><img alt=\"npm downloads\" src=\"https://img.shields.io/npm/dm/deepseek-mcp-server?logo=npm\" /></a>\n  <a href=\"https://github.com/DMontgomery40/deepseek-mcp-server/blob/main/server.json\"><img alt=\"OCI package\" src=\"https://img.shields.io/badge/OCI-docker.io%2Fdmontgomery40%2Fdeepseek--mcp--server%3A0.5.0-2496ED?logo=docker&logoColor=white\" /></a>\n  <a href=\"https://github.com/DMontgomery40/deepseek-mcp-server\"><img alt=\"GitHub stars\" src=\"https://img.shields.io/github/stars/DMontgomery40/deepseek-mcp-server?logo=github\" /></a>\n  <a href=\"https://glama.ai/mcp/servers/asht4rqltn\"><img alt=\"Glama MCP Listing\" src=\"https://img.shields.io/badge/Glama-MCP%20Listing-7B61FF\" /></a>\n  <a href=\"https://spark.entire.vc/assets/vb-deepseek-mcp-server?utm_source=github&utm_medium=readme\"><img alt=\"Listed on Spark\" src=\"https://spark.entire.vc/badges/listed.svg\" /></a>\n  <a href=\"https://spark.entire.vc/assets/vb-deepseek-mcp-server?utm_source=github&utm_medium=readme\"><img alt=\"Install via Spark\" src=\"https://spark.entire.vc/badges/vb-deepseek-mcp-server/install.svg\" /></a>\n</p>\n\nModel Context Protocol server for the current DeepSeek V4 API.\n\nAs of August 18, 2026, DeepSeek's public API reference documents:\n\n- `POST /chat/completions` with `deepseek-v4-flash` and `deepseek-v4-pro`\n- `POST /responses` with native OpenAI Responses API request and response shapes\n- `POST /beta/completions` for V4 Pro FIM completion\n- `GET /models`\n- `GET /user/balance`\n\nThis server exposes only those documented API surfaces. It does not ship a V4 monitor, speculative image/video/upload tools, or automatic model substitution.\n\n## Tools\n\n- `chat_completion`: DeepSeek V4 chat. Defaults to `deepseek-v4-flash`. Supports `thinking: { \"type\": \"enabled\" | \"disabled\" }`, `reasoning_effort: \"low\" | \"high\" | \"max\"`, JSON output, function tools, logprobs, streaming, and conversation memory.\n- `create_response`: Stateless native Responses API calls with text or structured input, reasoning effort controls, function tools, server-side web search, structured output, and semantic streaming.\n- `completion`: DeepSeek V4 Pro FIM completion. Defaults to `deepseek-v4-pro`.\n- `list_models`: Reads the live DeepSeek model list.\n- `get_user_balance`: Reads account balance and availability.\n- `reset_conversation`: Clears an in-memory conversation.\n- `list_conversations`: Lists in-memory conversation IDs.\n\n## Hosted Remote\n\n- URL: `https://deepseek-mcp.ragweld.com/mcp`\n- Auth: `Authorization: Bearer <token>`\n\nCodex CLI:\n\n```bash\nexport DEEPSEEK_MCP_AUTH_TOKEN=\"REPLACE_WITH_TOKEN\"\ncodex mcp add deepseek --url https://deepseek-mcp.ragweld.com/mcp --bearer-token-env-var DEEPSEEK_MCP_AUTH_TOKEN\n```\n\nClaude Code:\n\n```bash\nexport DEEPSEEK_MCP_AUTH_TOKEN=\"REPLACE_WITH_TOKEN\"\nclaude mcp add --transport http deepseek https://deepseek-mcp.ragweld.com/mcp --header \"Authorization: Bearer $DEEPSEEK_MCP_AUTH_TOKEN\"\n```\n\nCursor:\n\n```bash\nnode -e 'const fs=require(\"fs\"),p=process.env.HOME+\"/.cursor/mcp.json\";let j={mcpServers:{}};try{j=JSON.parse(fs.readFileSync(p,\"utf8\"))}catch{};j.mcpServers={...(j.mcpServers||{}),deepseek:{url:\"https://deepseek-mcp.ragweld.com/mcp\",headers:{Authorization:\"Bearer ${env:DEEPSEEK_MCP_AUTH_TOKEN}\"}}};fs.mkdirSync(process.env.HOME+\"/.cursor\",{recursive:true});fs.writeFileSync(p,JSON.stringify(j,null,2));'\n```\n\n## Local Stdio\n\n```bash\nDEEPSEEK_API_KEY=\"REPLACE_WITH_DEEPSEEK_KEY\" npx -y deepseek-mcp-server\n```\n\nDocker:\n\n```bash\ndocker pull docker.io/dmontgomery40/deepseek-mcp-server:0.5.0\ndocker run --rm -i -e DEEPSEEK_API_KEY=\"REPLACE_WITH_DEEPSEEK_KEY\" docker.io/dmontgomery40/deepseek-mcp-server:0.5.0\n```\n\n## Environment\n\nRequired:\n\n```bash\nDEEPSEEK_API_KEY=your-api-key\n```\n\nOptional:\n\n```bash\nDEEPSEEK_BASE_URL=https://api.deepseek.com\nDEEPSEEK_REQUEST_TIMEOUT_MS=120000\nDEEPSEEK_DEFAULT_MODEL=deepseek-v4-flash\nMCP_TRANSPORT=stdio\nMCP_HTTP_HOST=127.0.0.1\nMCP_HTTP_PORT=3001\nMCP_HTTP_PATH=/mcp\nMCP_HTTP_STATEFUL_SESSION=false\nMCP_HTTP_ALLOWED_ORIGINS=https://app.example.com,http://localhost:3000\nCONVERSATION_MAX_MESSAGES=200\n```\n\n`MCP_HTTP_ALLOWED_ORIGINS` is only needed for browser-based clients. Streamable HTTP requests that send an `Origin` header are rejected with `403` unless the exact origin appears in this comma-separated allowlist; normal MCP clients that omit `Origin` are unaffected.\n\n## Verification\n\n```bash\nnpm run build\nnpm test\nDEEPSEEK_API_KEY=\"REPLACE_WITH_DEEPSEEK_KEY\" npm run test:live\nDEEPSEEK_MCP_AUTH_TOKEN=\"REPLACE_WITH_TOKEN\" npm run test:remote\n```\n\nThe live smoke test performs real DeepSeek requests for model listing, balance, non-thinking chat, thinking streaming chat with `reasoning_content`, a native Responses API call, FIM completion, and MCP tool calls.\n\n## Protocol Compatibility\n\nThis release uses the supported `@modelcontextprotocol/sdk` v1 line and the 2025-era MCP initialization flow. Migrating to the split v2 packages and the 2026-07-28 protocol era is intentionally outside this maintenance update because it changes lifecycle and packaging contracts rather than being a drop-in dependency bump.\n\n## Registry Identity\n\n- MCP Registry name: `io.github.DMontgomery40/deepseek`\n- npm package: `deepseek-mcp-server`\n- OCI package: `docker.io/dmontgomery40/deepseek-mcp-server:0.5.0`\n\n## Official References\n\n- DeepSeek chat completions: <https://api-docs.deepseek.com/api/create-chat-completion>\n- DeepSeek Responses API: <https://api-docs.deepseek.com/api/create-response>\n- DeepSeek FIM completions: <https://api-docs.deepseek.com/api/create-completion>\n- DeepSeek models: <https://api-docs.deepseek.com/api/list-models>\n- DeepSeek balance: <https://api-docs.deepseek.com/api/get-user-balance>\n- MCP specification: <https://modelcontextprotocol.io/specification/2026-07-28>\n- MCP TypeScript SDK v2 migration guide: <https://github.com/modelcontextprotocol/typescript-sdk/blob/main/docs/migration/upgrade-to-v2.md>\n\n## License\n\nMIT\n",
  "bytes": 6600,
  "sha": "2f411e2aac301e3a97912be32603dd349098f70945e921d77f93eb666f2d9f30",
  "repo_slug": "dmontgomery40/deepseek-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_dmontgomery40_deepseek_1825da4c/readme"
}