MCP DeepSeek 示例项目

<p align="center"> <img src="https://img.shields.io/badge/状态-开发中-blue" alt="状态: 开发中"> <img src="https://img.shields.io/badge/版本-0.1.0-green" alt="版本 0.1.0"> <img src="https://img.shields.io/badge/语言-TypeScript-blue" alt="语言: TypeScript"> <img src="https://img.shields.io/badge/框架-Next.js-black" alt="框架: Next.js"> </p>

中文文档

认证

概述

MCP DeepSeek 示例 是一个基于 模型上下文协议（MCP） 构建的客户端应用，旨在与 DeepSeek AI 模型 进行交互。该项目展示了如何将 MCP 协议与 DeepSeek API 集成，以实现 工具调用 和 实时通信。

该项目遵循单仓库结构，包含两个主要组件：

• mcp-client：一个基于 Next.js 的前端应用，提供用户界面并集成 DeepSeek API。
• mcp-sse-server：一个使用 服务器发送事件（SSE） 实现实时工具执行的 MCP 服务器。

主要功能

✅ 现代中文/英文界面
✅ 与AI助手实时聊天
✅ 支持多种工具调用（产品查询、库存管理等）
✅ 基于SSE的实时通信
✅ 自动重连机制
✅ 响应式设计（移动设备及桌面）

快速开始

先决条件

• Node.js 16+ & npm/yarn/pnpm
• DeepSeek API 密钥

安装

1. 克隆仓库

git clone https://github.com/yourusername/mcp-deepseek-demo.git
cd mcp-deepseek-demo

2. 安装依赖

pnpm install

3. 配置环境变量

对于 mcp-client，创建 .env 并添加：

# MCP 服务器配置
MCP_SERVER_URL=http://localhost:8083/sse

# AI 提供商
DEEPSEEK_API_KEY=sk-...
DEEPSEEK_API_URL=https://api.deepseek.com/v1/chat/completions
DEFAULT_MODEL=deepseek-chat

对于 mcp-sse-server，创建 .env 并添加：

# 服务器配置
PORT=8083
ALLOWED_ORIGINS=http://localhost:3000,https://yourdomain.com
LOG_LEVEL=info
HEARTBEAT_INTERVAL=30000

运行项目

1. 启动 MCP 服务器和客户端

pnpm run dev

2. 在浏览器中打开 http://localhost:3000

---

项目结构

mcp-deepseek-demo/
├── packages/
│   ├── mcp-client/         # Next.js 前端
│   │   ├── app/            # 页面及路由
│   │   ├── components/     # React 组件
│   │   ├── lib/            # 工具和服务
│   │   └── public/         # 静态资源
│   └── mcp-sse-server/     # MCP SSE 服务器
│       ├── src/            # 服务器代码
│       ├── services/       # 业务逻辑
│       └── files/          # 文件操作
├── package.json           # 根配置
└── README.md              # 文档

---

用户指南

1. 连接到服务器

   • 客户端在启动时自动连接。
   • 连接状态显示在顶部。

2. 与AI助手聊天

   • 在输入框中键入消息。
   • AI会分析并回复。

3. 使用工具

   • 可用工具列在左侧面板。
   • 自然请求工具（例如，“获取所有产品”触发 getProducts）。

---

可用工具

🔧 getProducts：获取产品列表（模拟）
📦 getInventory：检查库存（模拟）
📝 getOrders：检索订单（模拟）
🛒 purchase：创建订单（模拟）
📂 getFiles：列出目录中的文件

---

技术栈

• 前端：Next.js, React, TypeScript, Tailwind CSS
• 后端：Node.js, TypeScript
• 通信：服务器发送事件（SSE）
• API：DeepSeek API, 模型上下文协议（MCP）

---

贡献

我们欢迎贡献！

1. 分叉 仓库
2. 创建分支 (git checkout -b feature/your-feature)
3. 提交更改 (git commit -m '添加了惊人的功能')
4. 推送到分支 (git push origin feature/your-feature)
5. 打开 拉取请求

---

许可证

MIT