使用说明

项目简介

本项目是一个 MCP (Model Context Protocol) 服务器，旨在帮助用户将 Deepseek 的强大语言模型集成到支持 MCP 协议的客户端应用中，例如 Claude Desktop。通过这个服务器，Claude Desktop 可以利用 Deepseek 模型进行对话、文本生成等任务，极大地扩展了 Claude Desktop 的模型选择范围。

主要功能点

Deepseek 模型集成: 允许 Claude Desktop 等 MCP 客户端调用 Deepseek 模型，利用 Deepseek 优秀的语言理解和生成能力。
工具调用: 实现 MCP 协议的工具调用功能，客户端可以通过 'ask-deepseek' 工具向 Deepseek 模型发送请求并获取响应。
灵活部署: 支持 Docker 容器化部署和本地 Python 环境运行，方便用户根据自身需求选择部署方式。
易于配置: 通过 '.env' 文件或环境变量配置 Deepseek API 密钥，方便快捷。
Claude Desktop 兼容: 提供详细的 Claude Desktop 配置文件示例，帮助用户快速上手。

安装步骤

克隆仓库: 打开终端，执行以下命令克隆仓库到本地：

git clone https://github.com/vincentf305/mcp-server-deepseek.git
cd mcp-server-deepseek

安装依赖: 确保你的 Python 环境中已安装 pip，然后执行以下命令安装项目依赖：
```
pip install -r requirements.txt
```
配置 Deepseek API 密钥: 在项目根目录下创建 '.env' 文件，并添加你的 Deepseek API 密钥：
```
DEEPSEEK_API_KEY=你的Deepseek API密钥
```
请将 '你的Deepseek API密钥' 替换为你实际的 Deepseek API 密钥。

服务器配置

要将此 MCP 服务器与 Claude Desktop 客户端连接，你需要在 Claude Desktop 的配置文件 'claude_desktop_config.json' 中添加以下服务器配置信息。请注意，以下配置示例使用 Docker 方式运行 MCP 服务器。

{
  "mcpServers": {
    "deepseek-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DEEPSEEK_API_KEY",
        "mcp_server_deepseek"
      ],
      "env": {
        "DEEPSEEK_API_KEY": "your_api_key_here" // 这里可以留空，因为API密钥通过 docker run -e 传入
      }
    }
  }
}

配置参数说明:

'"server name"': '"deepseek-server"' - 服务器名称，在 Claude Desktop 中用于标识和选择该服务器。
'"command"': '"docker"' - 启动 MCP 服务器的命令，这里使用 Docker 客户端。
'"args"': 启动命令的参数列表，用于运行 Docker 镜像：
- '"run"': Docker 运行命令。
- '"-i"': 保持标准输入 (STDIN) 打开，即使未连接。
- '"--rm"': 容器退出后自动删除容器。
- '"-e"': 设置环境变量。'"DEEPSEEK_API_KEY"' 表示将 'DEEPSEEK_API_KEY' 环境变量传递给 Docker 容器。
- '"mcp_server_deepseek"': Docker 镜像名称，与构建 Docker 镜像时指定的名称一致。
'"env"': 客户端启动服务器进程时设置的环境变量。在 Docker 方式中，API 密钥已经通过 'docker run -e' 传入，这里 'env' 可以留空，或者为了配置的完整性，可以保留，但 'your_api_key_here' 的值可以随意填写，因为实际值会被 Docker 命令的环境变量覆盖。

注意: 如果你选择本地 Python 环境运行服务器，请参考 'README.md' 中的本地运行指南，并相应修改 Claude Desktop 的 'command' 和 'args' 配置。

基本使用方法

确保已完成安装步骤并配置好 Claude Desktop。
启动 MCP 服务器（通过 Docker 或本地 Python 运行）。
重启 Claude Desktop，使新的服务器配置生效。
在 Claude Desktop 中选择配置的 '"server name"' (例如 "deepseek-server")。
使用 Claude Desktop 的工具调用功能，可以找到名为 'ask-deepseek' 的工具，使用该工具即可与 Deepseek 模型进行交互。具体工具的使用方法和参数可以参考工具的描述信息。

关键词