关键词

AI工具上下文服务SSE工具调用实时通信

使用说明

项目简介

本项目 'mcp-deepseek-demo' 包含一个基于 Model Context Protocol (MCP) 协议的服务器 'mcp-sse-server' 和一个客户端应用 'mcp-client'。其中 'mcp-sse-server' 是一个 MCP 服务器的示例实现，它通过 Server-Sent Events (SSE) 与客户端通信，并集成了 DeepSeek AI 模型，对外提供了一系列预定义的工具，例如产品查询、库存管理和文件访问等。客户端应用 'mcp-client' 则提供了一个用户友好的界面，方便用户与 AI 助手进行交互，并体验工具调用功能。

主要功能点

  • MCP协议支持: 实现了 MCP 协议，可以作为 LLM 应用的后端，提供上下文服务。
  • 工具调用: 支持注册和执行多种工具，例如：
    • 'getProducts': 获取产品列表
    • 'getInventory': 获取库存信息
    • 'getOrders': 获取订单信息
    • 'purchase': 创建购买订单
    • 'getFiles': 获取文件列表
  • SSE通信: 使用 Server-Sent Events (SSE) 作为主要的通信协议，实现实时数据传输。
  • DeepSeek 集成: 虽然项目名称包含 DeepSeek，但 'mcp-sse-server' 本身是一个通用的 MCP 服务器，工具的实现是模拟数据或本地文件系统操作，与特定的 DeepSeek 模型 API 调用无关。DeepSeek 模型 API 的集成是在客户端 'mcp-client' 中完成的，用于演示如何结合 MCP 服务器和 LLM。
  • 可扩展性: 服务器端工具易于扩展，可以根据需求添加更多功能。

安装步骤

  1. 克隆仓库 
    git clone https://github.com/Ulanxx/mcp-deepseek-demo.git
cd mcp-deepseek-demo
  2. 安装依赖 
    pnpm install
  3. 配置环境变量
    • 在 'packages/mcp-sse-server' 目录下创建 '.env' 文件，并配置服务器端口和允许的客户端来源： 
      PORT=8083
ALLOWED_ORIGINS=http://localhost:3000,https://yourdomain.com
    • 在 'packages/mcp-client' 目录下创建 '.env' 文件，配置 MCP 服务器地址和 DeepSeek API 密钥（客户端与 DeepSeek API 交互，服务端本身不直接依赖 DeepSeek API，但客户端演示了如何结合）： 
      MCP_SERVER_URL=http://localhost:8083/sse
DEEPSEEK_API_KEY=sk-...
DEEPSEEK_API_URL=https://api.deepseek.com/v1/chat/completions
DEFAULT_MODEL=deepseek-chat

服务器配置

MCP 客户端需要配置 MCP 服务器的连接地址。在 'packages/mcp-client/.env' 文件中，'MCP_SERVER_URL' 变量指定了 MCP 服务器的 SSE 端点地址。默认配置如下：

{
  "serverUrl": "http://localhost:8083/sse"
}
  • 'serverUrl': MCP 服务器的 SSE 连接地址。客户端通过此地址与服务器建立连接。

基本使用方法

  1. 启动服务器和客户端 在项目根目录下运行： 
    pnpm run dev
    这将同时启动 'mcp-sse-server' (默认端口 8083) 和 'mcp-client' (默认地址 'http://localhost:3000')。
  2. 访问客户端 打开浏览器访问 'http://localhost:3000'，即可使用客户端应用。
  3. 体验工具调用 在聊天界面中，可以与 AI 助手对话，并尝试使用工具。例如，输入指令让 AI 助手使用 'getProducts' 工具获取产品列表，或使用 'purchase' 工具进行购买操作。左侧工具栏会显示可用的工具列表。

信息

分类

AI与计算

访问项目