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 자체 HTTP API를 구현하지 않고도 DeepSeek와 통신할 수 있게 합니다.

핵심 기능

기능	작동 방식	얻을 수 있는 것
채팅 완성	DeepSeek에 `/v1/chat/completions` 요청(또는 베타 엔드포인트)을 선택적으로 이미지와 함께 보냅니다.	텍스트 응답, 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`, 파일당 64MiB 크기 제한.
대화 메모리	`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 환경 변수 하나만 필요합니다.

누가 사용할까요?

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 – 서버를 자유롭게 사용, 수정, 재배포할 수 있습니다.