DMontgomery40/deepseek-mcp-server

DeepSeek MCP サーバー – 概要

DeepSeek MCP サーバー は、Model Context Protocol (MCP) と DeepSeek の V4.1 Flash および V4 Pro 言語モデル API の間のブリッジとして機能する小さな Node.js プログラムです。実際には、MCP を理解するツール (たとえば、Claude、Codex、またはカスタムの MCP 対応クライアント) が DeepSeek と通信できるようにし、各クライアントが DeepSeek 独自の HTTP API を実装する必要をなくします。

中核機能

機能	仕組み	得られるもの
チャット補完	`/v1/chat/completions` リクエスト (またはベータ版エンドポイント) を DeepSeek に送信します。オプションで画像も送信できます。	テキスト応答、JSON 構造化出力、ストリーミング、オプションのインメモリ会話メモリ (`conversation_id`)。
Responses API	DeepSeek の Responses エンドポイントを呼び出します。テキストまたは画像を返すことができます。	カスタムツール `apply_patch` と構造化出力を含めることができるステートレス呼び出し。
FIM 補完	DeepSeek の `/beta/completions` エンドポイントを使用して、途中補完 (fill-in-the-middle) を生成します。	オプションのストリーミングを備えたテキスト補完。出力トークンは約 4K に制限されます。
モデル検出と残高	DeepSeek の `/models` および `/balance` エンドポイントをラップします。	利用可能なモデル、その制限を一覧表示し、アカウントのクレジットを表示します。
Files API	DeepSeek のストレージ上の画像ファイルをアップロード、一覧表示、取得、削除します。	ビジョン入力用の再利用可能な `file_id`。サイズ制限 (ファイルあたり 64 MiB)。
会話メモリ	最近のメッセージを `conversation_id` ごとにインメモリに短時間保持します。	リクエストごとに完全な履歴を再送信せずにチャットを続行できます。
レート制限と認証	オプションの HTTP トランスポート用のシンプルなトークンベース認証とグローバルなツールレート制限。	DeepSeek クォータの誤用による過剰使用を防止します。

実行方法

STDIO モード (デフォルト) – npx deepseek-mcp-server@1 で起動し、MCP JSON メッセージを stdin/stdout でパイプします。ローカル CLI ツールに最適です。
HTTP モード – MCP_TRANSPORT=streamable-http を設定し、ホスト/ポートを指定します。サーバーは http://127.0.0.1:3001/mcp で待機し、ブラウザや他のサービスから呼び出すことができます。

どちらのモードでも、環境変数は DEEPSEEK_API_KEY の 1 つだけが必要です。

誰がこれを使うのか?

MCP 対応アシスタント (Claude、Codex など) を構築する開発者 – DeepSeek 固有のリクエストコードを書かずに DeepSeek をバックエンドとして使用したい場合。
RAG またはマルチモーダルパイプライン – 画像を DeepSeek のビジョンモデルに送信する必要がある場合。サーバーがファイルアップロードのライフサイクルを処理します。
テストまたはプロトタイピング – npm パッケージには、実際の DeepSeek アカウントに対してすべてのツールを実行するライブスモークテストスイートが同梱されています。

これがしないこと

画像、ビデオ、オーディオを生成することはありません。テキストと画像の理解のみです。
任意の OpenAI 互換 API 用の本格的なゲートウェイではありません。DeepSeek が現在提供しているエンドポイントのみを実装します。

クイックスタート (コピー＆ペースト)

# 1️⃣ インストール/実行 (Node 20+ が必要)
DEEPSEEK_API_KEY=YOUR_KEY npx -y deepseek-mcp-server@1

# 2️⃣ MCP クライアント設定の例 (JSON)
{
  "mcpServers": {
    "deepseek": {
      "command": "npx",
      "args": ["-y", "deepseek-mcp-server@1"],
      "env": {"DEEPSEEK_API_KEY": "YOUR_KEY"}
    }
  }
}

これで、MCP 互換クライアントは deepseek サーバーを介して chat_completion、list_models、upload_file などのツールを呼び出せるようになります。

詳細情報

公式 DeepSeek ドキュメント – モデル制限、価格、ビジョンガイドのリンクは README にあります。
MCP 仕様 (2026-07-28) – このサーバーが実装するプロトコル。
GitHub リポジトリ – 完全なソース、テスト、監査ドキュメント (docs/research/...) が含まれています。

ライセンス

MIT – サーバーを自由に使用、変更、再配布できます。