MCP 服务器

AI Customer Support Bot - MCP Server

一个模型上下文协议 (MCP) 服务器，它使用 Cursor AI 和 Glama.ai 集成来提供 AI 驱动的客户支持。

README

AI 客户支持机器人 - MCP 服务器

一个模型上下文协议 (MCP) 服务器，它使用 Cursor AI 和 Glama.ai 集成提供 AI 驱动的客户支持。

功能

从 Glama.ai 实时获取上下文
使用 Cursor AI 生成 AI 驱动的响应
批量处理支持
优先级队列
速率限制
用户交互跟踪
健康监控
符合 MCP 协议

前提条件

Python 3.8+
PostgreSQL 数据库
Glama.ai API 密钥
Cursor AI API 密钥

安装

克隆存储库：

git clone <repository-url>
cd <repository-name>

创建并激活虚拟环境：

python -m venv venv
source venv/bin/activate  # 在 Windows 上：venv\Scripts\activate

安装依赖项：

pip install -r requirements.txt

基于 .env.example 创建一个 .env 文件：

cp .env.example .env

使用您的凭据配置您的 .env 文件：

# API 密钥
GLAMA_API_KEY=your_glama_api_key_here
CURSOR_API_KEY=your_cursor_api_key_here

# 数据库
DATABASE_URL=postgresql://user:password@localhost/customer_support_bot

# API URL
GLAMA_API_URL=https://api.glama.ai/v1

# 安全
SECRET_KEY=your_secret_key_here

# MCP 服务器配置
SERVER_NAME="AI 客户支持机器人"
SERVER_VERSION="1.0.0"
API_PREFIX="/mcp"
MAX_CONTEXT_RESULTS=5

# 速率限制
RATE_LIMIT_REQUESTS=100
RATE_LIMIT_PERIOD=60

# 日志
LOG_LEVEL=INFO

设置数据库：

# 创建数据库
createdb customer_support_bot

# 运行迁移（如果使用 Alembic）
alembic upgrade head

运行服务器

启动服务器：

python app.py

服务器将在 http://localhost:8000 上可用

API 端点

1. 根端点

GET /

返回基本服务器信息。

2. MCP 版本

GET /mcp/version

返回支持的 MCP 协议版本。

3. 功能

GET /mcp/capabilities

返回服务器功能和支持的特性。

4. 处理请求

POST /mcp/process

处理带有上下文的单个查询。

示例请求：

curl -X POST http://localhost:8000/mcp/process \
  -H "Content-Type: application/json" \
  -H "X-MCP-Auth: your-auth-token" \
  -H "X-MCP-Version: 1.0" \
  -d '{
    "query": "如何重置我的密码？",
    "priority": "high",
    "mcp_version": "1.0"
  }'

5. 批量处理

POST /mcp/batch

在单个请求中处理多个查询。

示例请求：

curl -X POST http://localhost:8000/mcp/batch \
  -H "Content-Type: application/json" \
  -H "X-MCP-Auth: your-auth-token" \
  -H "X-MCP-Version: 1.0" \
  -d '{
    "queries": [
      "如何重置我的密码？",
      "你们的营业时间是什么？",
      "如何联系支持？"
    ],
    "mcp_version": "1.0"
  }'

6. 健康检查

GET /mcp/health

检查服务器健康状况和服务状态。

速率限制

服务器实现了速率限制，默认值如下：

每 60 秒 100 个请求
速率限制信息包含在健康检查端点中
超过速率限制的响应包括重置时间

错误处理

服务器以以下格式返回结构化的错误响应：

{
  "code": "ERROR_CODE",
  "message": "错误描述",
  "details": {
    "timestamp": "2024-02-14T12:00:00Z",
    "additional_info": "value"
  }
}

常见错误代码：

RATE_LIMIT_EXCEEDED: 超过速率限制
UNSUPPORTED_MCP_VERSION: 不支持的 MCP 版本
PROCESSING_ERROR: 处理请求时出错
CONTEXT_FETCH_ERROR: 从 Glama.ai 获取上下文时出错
BATCH_PROCESSING_ERROR: 处理批量请求时出错

开发

项目结构

.
├── app.py              # 主应用程序文件
├── database.py         # 数据库配置
├── middleware.py       # 中间件（速率限制、验证）
├── models.py          # 数据库模型
├── mcp_config.py      # MCP 特定配置
├── requirements.txt   # Python 依赖项
└── .env              # 环境变量