使用说明

项目简介

本项目是一个现代化的客户支持和工单管理系统，使用 Next.js、Tailwind CSS 和 Prisma 构建。其核心亮点在于集成了 Model Context Protocol (MCP)，能够作为 MCP 服务器为 LLM 客户端（如 Cursor 编辑器）提供上下文信息和代码分析等功能，从而增强 AI 助手在代码编写和理解方面的能力。

主要功能点

工单管理: 提供用户和管理员面板，支持创建、跟踪和管理客户支持工单。
实时消息: 具备实时消息传递功能，方便客服与用户沟通。
MCP 集成: 内置 Model Control Protocol (MCP) 服务器功能，可以与支持 MCP 协议的 LLM 客户端连接。连接后，可以为 LLM 客户端提供：
- 代码分析工具: 允许 LLM 客户端调用服务器端的代码分析工具，辅助代码理解和问题排查。
- 项目文件访问: 使 LLM 客户端能够访问项目中的文件内容（例如，通过 'proje-dosyası' 资源），为 LLM 提供更丰富的上下文信息。

安装步骤

克隆仓库:

git clone https://github.com/mistikdiyebiri/musteri-destek-sistemi.git
cd musteri-destek-sistemi

安装依赖:

npm install --legacy-peer-deps

配置环境变量:
- 复制 '.env.example' 文件为 '.env'：
```
cp .env.example .env
```
- 修改 '.env' 文件，配置数据库连接 ('DATABASE_URL')、NextAuth 密钥 ('NEXTAUTH_SECRET') 等必要的环境变量。
- 重要: 请务必配置数据库连接，因为该系统依赖 PostgreSQL 数据库。
生成 Prisma 客户端:
```
npx prisma generate
```
同步数据库:
```
npx prisma db push
```
启动开发服务器:
```
npm run dev
```
应用将运行在 'http://localhost:3000'。

服务器配置 (MCP 客户端)

要将此项目作为 MCP 服务器连接到 MCP 客户端（例如 Cursor 编辑器），您需要在 MCP 客户端中配置服务器连接信息。以下是一个典型的配置示例（JSON 格式）：

{
  "serverName": "musteri-destek-sistemi-mcp",
  "command": "npm",
  "args": ["run", "dev"]
}

配置参数说明:

'serverName': MCP 服务器的名称，可以自定义，用于在客户端标识不同的服务器连接。例如 '"musteri-destek-sistemi-mcp"'。
'command': 启动 MCP 服务器的命令。由于本项目使用 'npm run dev' 启动 Next.js 开发服务器，因此这里设置为 '"npm"'。
'args': 启动命令的参数。 'npm run dev' 命令的参数为 '["run", "dev"]'。

注意: 请确保您的 MCP 客户端支持通过 'command' 和 'args' 配置启动外部 MCP 服务器。某些客户端可能需要您手动启动服务器，然后配置服务器的 URL。在这种情况下，您需要先运行 'npm run dev' 启动服务器，然后将服务器的 URL (例如 'http://localhost:3000/api/mcp') 配置到 MCP 客户端中。本项目默认的 MCP 端点为 '/api/mcp'。

基本使用方法

启动 MCP 服务器: 按照上述安装步骤启动客户支持系统。
配置 MCP 客户端: 在您的 MCP 客户端（如 Cursor 编辑器）中，根据客户端的指引，配置 MCP 服务器连接。
- 如果客户端支持 'command' 和 'args' 配置，请使用上述提供的 JSON 配置。
- 如果客户端需要手动配置 URL，请将 MCP 服务器的 URL (例如 'http://localhost:3000/api/mcp') 填入客户端配置中，并确保服务器已在运行。
连接和使用: 客户端成功连接到 MCP 服务器后，您应该可以在客户端中体验到由 MCP 服务器提供的增强功能，例如：
- 在 Cursor 中，您可以使用 AI 助手进行代码分析，并让 AI 助手访问项目文件以获取更全面的上下文信息。
- 具体的功能调用方式和效果取决于 MCP 客户端的功能设计。

关键词