@arikusi/deepseek-mcp-server 1.4.3 → 1.5.0

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.5.0] - 2026-03-07
+
+### Added
+- **Remote Endpoint**: Hosted BYOK (Bring Your Own Key) endpoint at `https://deepseek-mcp.tahirl.com/mcp`. Users send their own DeepSeek API key as Bearer token — no server-side key stored.
+- **Cloudflare Worker**: Stateless MCP server on Cloudflare Workers edge network. Zero cold start, global distribution, free tier (100K requests/day).
+- **Remote Quick Start**: Claude Code, Cursor, Windsurf can connect to the remote endpoint with `--transport http` — no npm install or Node.js required.
+
+### Changed
+- README restructured: Remote (no install) as primary quick start, local stdio as secondary.
+- server.json: Added streamableHttp transport package for remote endpoint.
+- llms.txt/llms-full.txt: Updated with remote endpoint documentation.
+
 ## [1.4.3] - 2026-03-07
 
 ### Fixed
@@ -264,8 +276,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Version History
 
+- **1.5.0** (2026-03-07): Cloudflare Workers remote endpoint (BYOK), deepseek-mcp.tahirl.com
 - **1.4.3** (2026-03-07): MCP Registry description fix
 - **1.4.2** (2026-03-07): Streamable HTTP transport, Docker support, health endpoint, 253 tests
+- **1.4.1** (2026-03-07): MCP Registry, Glama registry, Smithery compatibility
 - **1.4.0** (2026-03-07): Model-aware pricing, multimodal content types, flexible fallback chain, MCP Registry, 241 tests
 - **1.3.3** (2026-03-07): Streaming fallback tests, session tool_calls fix, configurable circuit breaker, session message limit, 212 tests
 - **1.3.2** (2026-03-06): OpenAI SDK v6, Zod v4, DEFAULT_MODEL config
@@ -284,7 +298,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - [GitHub repository](https://github.com/arikusi/deepseek-mcp-server)
 - [Issue tracker](https://github.com/arikusi/deepseek-mcp-server/issues)
 
-[Unreleased]: https://github.com/arikusi/deepseek-mcp-server/compare/v1.4.3...HEAD
+[Unreleased]: https://github.com/arikusi/deepseek-mcp-server/compare/v1.5.0...HEAD
+[1.5.0]: https://github.com/arikusi/deepseek-mcp-server/compare/v1.4.3...v1.5.0
 [1.4.3]: https://github.com/arikusi/deepseek-mcp-server/compare/v1.4.2...v1.4.3
 [1.4.2]: https://github.com/arikusi/deepseek-mcp-server/compare/v1.4.1...v1.4.2
 [1.4.1]: https://github.com/arikusi/deepseek-mcp-server/compare/v1.4.0...v1.4.1

package/README.md

@@ -22,31 +22,49 @@ MCP server for DeepSeek AI models (Chat + Reasoner). Supports stdio and HTTP tra
 
 ## Quick Start
 
-### For Claude Code
+### Remote (No Install)
 
+Use the hosted endpoint directly — no npm install, no Node.js required. Bring your own DeepSeek API key:
+
+**Claude Code:**
 ```bash
-# Install and configure with API key (available in all projects)
-claude mcp add -s user deepseek npx @arikusi/deepseek-mcp-server -e DEEPSEEK_API_KEY=your-key-here
+claude mcp add --transport http deepseek \
+  https://deepseek-mcp.tahirl.com/mcp \
+  --header "Authorization: Bearer YOUR_DEEPSEEK_API_KEY"
+```
 
-# Or install for current project only
-claude mcp add deepseek npx @arikusi/deepseek-mcp-server -e DEEPSEEK_API_KEY=your-key-here
+**Cursor / Windsurf / VS Code:**
+```json
+{
+  "mcpServers": {
+    "deepseek": {
+      "url": "https://deepseek-mcp.tahirl.com/mcp",
+      "headers": {
+        "Authorization": "Bearer ${DEEPSEEK_API_KEY}"
+      }
+    }
+  }
+}
 ```
 
-**Scope options:**
-- `-s user`: Available in all your projects (recommended)
-- `-s local`: Only in current project (default)
-- `-s project`: Project-specific `.mcp.json` file
+### Local (stdio)
 
-### For Gemini CLI
+**Claude Code:**
+```bash
+claude mcp add -s user deepseek npx @arikusi/deepseek-mcp-server -e DEEPSEEK_API_KEY=your-key-here
+```
 
+**Gemini CLI:**
 ```bash
-# Install and configure with API key
 gemini mcp add deepseek npx @arikusi/deepseek-mcp-server -e DEEPSEEK_API_KEY=your-key-here
 ```
 
-**Get your API key:** [https://platform.deepseek.com](https://platform.deepseek.com)
+**Scope options** (Claude Code):
+- `-s user`: Available in all your projects (recommended)
+- `-s local`: Only in current project (default)
+- `-s project`: Project-specific `.mcp.json` file
 
-That's it! Your MCP client can now use DeepSeek models!
+**Get your API key:** [https://platform.deepseek.com](https://platform.deepseek.com)
 
 ---
 
@@ -65,7 +83,8 @@ That's it! Your MCP client can now use DeepSeek models!
 - **12 Prompt Templates**: Templates for debugging, code review, function calling, and more
 - **Streaming Support**: Real-time response generation
 - **Multimodal Ready**: Content part types for text + image input (enable with `ENABLE_MULTIMODAL=true`)
-- **HTTP Transport**: Remote access via Streamable HTTP with `TRANSPORT=http`
+- **Remote Endpoint**: Hosted at `deepseek-mcp.tahirl.com/mcp` — BYOK (Bring Your Own Key), no install needed
+- **HTTP Transport**: Self-hosted remote access via Streamable HTTP with `TRANSPORT=http`
 - **Docker Ready**: Multi-stage Dockerfile with health checks for containerized deployment
 - **Tested**: 253 tests with 90%+ code coverage
 - **Type-Safe**: Full TypeScript implementation
@@ -411,6 +430,10 @@ claude mcp add -s user deepseek npx @arikusi/deepseek-mcp-server \
 
 ```
 deepseek-mcp-server/
+├── worker/                  # Cloudflare Worker (remote BYOK endpoint)
+│   ├── src/index.ts         # Worker entry point
+│   ├── wrangler.toml        # Cloudflare config
+│   └── package.json
 ├── src/
 │   ├── index.ts              # Entry point, bootstrap
 │   ├── server.ts             # McpServer factory (auto-version)
@@ -484,9 +507,32 @@ npm start
 
 The server will start and wait for MCP client connections via stdio.
 
-### HTTP Transport
+### Remote Endpoint (Hosted)
+
+A hosted BYOK (Bring Your Own Key) endpoint is available at:
+
+```
+https://deepseek-mcp.tahirl.com/mcp
+```
+
+Send your DeepSeek API key as `Authorization: Bearer <key>`. No server-side API key stored — your key is used directly per request. Powered by Cloudflare Workers (global edge, zero cold start).
+
+> **Note:** The `deepseek-reasoner` model may take over 30 seconds for complex queries. Some MCP clients (e.g. Claude Code) have built-in tool call timeouts that may interrupt long-running requests. For complex tasks, `deepseek-chat` is recommended.
+
+```bash
+# Test health
+curl https://deepseek-mcp.tahirl.com/health
+
+# Test MCP (requires auth)
+curl -X POST https://deepseek-mcp.tahirl.com/mcp \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer YOUR_KEY" \
+  -d '{"jsonrpc":"2.0","method":"initialize","params":{"capabilities":{}},"id":1}'
+```
+
+### HTTP Transport (Self-Hosted)
 
-Run the server as an HTTP endpoint for remote access:
+Run your own HTTP endpoint:
 
 ```bash
 TRANSPORT=http HTTP_PORT=3000 DEEPSEEK_API_KEY=your-key node dist/index.js
@@ -495,7 +541,6 @@ TRANSPORT=http HTTP_PORT=3000 DEEPSEEK_API_KEY=your-key node dist/index.js
 Test the health endpoint:
 ```bash
 curl http://localhost:3000/health
-# → {"status":"ok","version":"1.4.2","uptime":5.2,"transport":"http","timestamp":"..."}
 ```
 
 The MCP endpoint is available at `POST /mcp` (Streamable HTTP protocol).

package/dist/server.js

@@ -6,7 +6,7 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { readFileSync } from 'fs';
 import { dirname, join } from 'path';
 import { fileURLToPath } from 'url';
-let version = '1.4.3';
+let version = '1.5.0';
 try {
     const __dirname = dirname(fileURLToPath(import.meta.url));
     const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arikusi/deepseek-mcp-server",
-  "version": "1.4.3",
+  "version": "1.5.0",
   "mcpName": "io.github.arikusi/deepseek",
   "description": "MCP Server for DeepSeek API integration - enables Claude Code to use DeepSeek Chat and Reasoner models",
   "main": "dist/index.js",