article
README
🚀 AI 客户支持机器人 - MCP 服务器
本项目是一个借助 Cursor AI 和 Glama.ai 集成的 AI 驱动客户支持的模型上下文协议 (MCP) 服务器,它能实时从 Glama.ai 获取上下文,利用 Cursor AI 生成智能响应,为客户支持工作带来高效与智能的体验。
🚀 快速开始
先决条件
- 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文件,使用以下示例:
# 环境变量配置示例
DATABASE_URL=postgresql://user:password@localhost/dbname
API_KEY=your_api_key_here
MCP_SERVER_ADDRESS=http://localhost:8080
- 完成安装后,启动服务器:
python app.py
✨ 主要特性
- 实时从 Glama.ai 获取上下文
- 使用 Cursor AI 生成 AI 驱动的响应
- 批量处理支持
- 优先级队列
- 速率限制
- 用户交互跟踪
- 健康监控
- MCP 协议符合性
📚 详细文档
配置
所有 MCP 端点均要求通过 X-MCP-Auth 标头进行身份验证。
使用说明
- 更新
mcp_config.py添加新的配置选项 - 如果需要新增模型,请在
models.py中添加 - 在
app.py中创建新的端点 - 更新功能端以反映新特性
注意事项
⚠️ 重要提示
- 所有 MCP 端点均要求通过
X-MCP-Auth标头进行身份验证。- 实现了速率限制以防止滥用
- 数据库凭证需保持安全
- API 密钥请勿提交到版本控制中
健康监控
服务器提供了用于监控的端点:
- 服务状态
- 速率限制使用情况
- 已连接服务
- 处理时间
错误处理
可能错误代码
| 错误代码 | 描述 | |---------|------| | 401 | 未授权 | | 503 | 服务不可用 | | 429 | 请求过多 |
贡献指南
- 分叉仓库
- 创建功能分支
- 提交更改
- 推送到分支
- 创建拉取请求
📄 许可证
本项目在 MIT 许可证下发布 - 请查看 LICENSE 文件获取详细信息。
🔧 支持
如需支持,请在仓库中创建问题或联系开发团队。
扫码联系在线客服