convez.ai
MCP ServerAutomaçãoAvançado
xiaohe9

Helpdesk MCP Server - Agente de Suporte IT Inteligente

xiaohe9/helpdesk-mcp-server

Agente IT helpdesk com RAG, 4 tools MCP e memória conversacional

Ver no GitHub
InicialPluginScore · de 0 a 100

Sistema de helpdesk baseado em LangGraph + MCP que implementa um agente ReAct com recuperação aumentada (RAG) via ChromaDB, oferecendo ferramentas para busca em base de conhecimento IT, consulta de tickets, reset de senhas e escalação para atendimento humano. Inclui memória persistente em SQLite e validação anti-alucinação em três camadas.

Instalação

$npx convez-ai xiaohe9/helpdesk-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
14%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Atender automaticamente dúvidas técnicas de usuários finais (VPN, conectividade, acesso)
  • Consultar status e histórico de tickets de suporte em tempo real
  • Realizar reset de senhas e redefinições de credenciais com segurança
  • Escalar casos complexos para fila de atendimento humano com rastreamento

Veredito

Implementação sólida de agent IT com arquitetura produção-ready: MCP bem estruturado, RAG com ChromaDB, memória persistente e 3 camadas anti-alucinação. Ideal para equipes DevOps/SRE que precisam automatizar suporte técnico com IA confiável e rastreável.

README

A tradução para o português deste README ainda está na fila.

Helpdesk MCP Server - AI IT Support Agent

基于 LangGraph + MCP (Model Context Protocol) + ChromaDB RAG 的 IT Helpdesk 智能客服系统,实现自然语言到 IT 运维工具的端到端智能交互。


核心功能

模块说明
ReAct Agent任务规划 → 工具调用 → 结果反馈的完整循环,支持多轮对话
MCP Server4 个标准化 Tool 封装 IT 运维操作,JSON-RPC 2.0 协议
RAG 检索增强ChromaDB 向量数据库,IT 知识库文档召回率 80%+
三层防幻觉硬规则拦截 → RAG 交叉验证 → Confidence 阈值兜底
记忆模块SQLite 长期记忆,完整对话历史,多轮上下文连贯
Flask 健康检查RESTful API 接口,支持服务状态监控

系统架构

用户输入自然语言(IT问题)
    │
    ▼
┌─────────────────────────────────────┐
│     LangGraph StateGraph            │
│  ┌─────────┐    ┌──────────────┐   │
│  │ Agent   │───→│ 条件判断      │   │
│  │ 节点    │    │ should_      │   │
│  │(LLM推理)│←───│  continue    │   │
│  └────┬────┘    └──────┬───────┘   │
│       │                │            │
│       │         ┌──────┘            │
│       │         ▼                   │
│       │    ┌──────────┐             │
│       │    │  Tools   │             │
│       │    │  节点     │             │
│       │    └────┬─────┘             │
│       │         │                   │
│       └─────────┘                   │
└─────────────────────────────────────┘
    │
    ▼
┌──────────────┐  ┌──────────────┐  ┌──────────────┐
│  MCP Server  │  │   ChromaDB   │  │   SQLite     │
│  4个 Tool    │  │  向量检索     │  │  记忆存储     │
└──────┬───────┘  └──────────────┘  └──────────────┘
       │
    ┌──┴──┬──────────┬──────────┐
    ▼     ▼          ▼          ▼
 search_ query_   reset_     escalate_
 kb     ticket    password   human

4个 MCP Tool

Tool功能示例
search_kbIT知识库RAG检索"VPN连接失败怎么办?" → 返回5步排查方案
query_ticket工单状态查询"查询工单 T-002" → 返回状态/处理人/优先级
reset_password密码重置"重置邮箱密码 zhangsan" → 生成临时密码
escalate_human转人工处理"转人工" → 队列号+预估等待时间

快速开始

环境要求

  • Python 3.10+
  • pip

安装

git clone https://github.com/xiaohe9/helpdesk-mcp-server.git
cd helpdesk-mcp-server

# 创建虚拟环境
python -m venv .venv
source .venv/bin/activate  # Linux/Mac
# .venv\Scripts\activate  # Windows

pip install -r requirements.txt

运行

# 启动 Flask 健康检查服务
python app.py

# 运行 AI Agent(交互模式)
python agent_with_memory.py

演示效果

用户: VPN连接失败怎么办?
→ [Agent] 调用 search_kb
→ [RAG] ChromaDB 检索 IT 知识库
→ [返回] 5步排查方案 ✅

用户: 查询工单 T-002
→ [Agent] 调用 query_ticket
→ [返回] 状态:处理中 / 处理人:李工程师 / 优先级:高 ✅

用户: 重置邮箱密码 zhangsan
→ [Agent] 调用 reset_password
→ [返回] 临时密码: Temp@789012 / 首次登录需修改 ✅

用户: 转人工
→ [Agent] 调用 escalate_human
→ [返回] 队列号: Q-15C1A3 / 预估等待: 3分钟 ✅

对话历史: 完整记录在 SQLite conversations.db ✅

技术栈

  • Agent 框架: LangGraph (ReAct 模式)
  • 工具协议: MCP (Model Context Protocol)
  • 向量数据库: ChromaDB
  • 记忆存储: SQLite
  • Web 框架: Flask
  • 语言: Python 3.10+

文件结构

helpdesk-mcp-server/
├── .cursorrules          # Cursor 项目约束定义
├── .gitignore            # Git 忽略规则
├── app.py                # Flask 健康检查接口
├── mcp_server.py         # 4 个 MCP Tool 实现
├── it_support_data.py    # 模拟 IT 知识库与工单数据
├── rag_engine.py         # ChromaDB 向量检索引擎
├── agent_with_memory.py  # LangGraph Agent + SQLite 记忆
├── requirements.txt      # Python 依赖
└── README.md             # 本文件

开发方式

本项目使用 Cursor + Vibe Coding 开发,基于 .cursorrules 约束文件驱动 AI 代码生成,完整对标 flight-mcp-server 架构,验证 AI Agent 系统的业务场景复用能力。

Ver o original no GitHub

Bom para

Relacionados