🚀 Henry大师班：人工智能自动化与模型上下文协议（MCP）
专业示范项目 教您如何通过MCP和光标将业务系统连接到IAS。
📚 什么是MCP，为什么光标需要它？
问题
LLMS（如Claude或GPT）非常强大，但有一个基本限制： 他们只知道他们的训练数据中有什么。他们无法访问：
- 您的客户数据库
- 您的机票支持系统
- 您的内部CRM
- 员工API
- 私人档案和文件
解决方案：模型上下文协议
主控程序 这是由Anthropic创建的开放标准，允许IAS安全地连接到外部数据源。将其视为“IAS的USB”：
┌─────────────┐ ┌──────────┐ ┌──────────────┐
│ Cursor │ ◄─MCP──►│ Servidor │ ◄──────►│ Base de Datos│
│ (Cliente) │ │ MCP │ │ SQLite │
└─────────────┘ └──────────┘ └──────────────┘关键好处：
- ✅ 上下文访问：人工智能可以实时查询数据
- ✅ 安全：对人工智能可以做什么进行精细控制
- ✅ 标准化：一个协议，多个应用程序
- ✅ Bidireccional：您不仅可以阅读，还可以执行操作
为什么光标需要MCP？
Cursor是人工智能增强的IDE，但没有MCP，它对您的业务系统“视而不见”。与MCP：
- 您可以直接从聊天室查询您的数据库
- 可以通过分析实际数据生成报告
- 您可以根据当前的体系结构建议代码
- 您可以自动化连接到您系统的任务
______________________________________________________________________
🛠️ 项目设置
先决条件
1.安装依赖项
poetry install这将安装：
mcp：MCP协议库fastmcp：轻松创建MCP服务器的框架
2.生成测试数据库
poetry run python scripts/setup_db.py此脚本创建 soporte.db 有60张逼真的门票，模拟真实的技术支持系统。
预期退出：
✅ Base de datos creada exitosamente!
Total de tickets: 60
Distribución por prioridad:
- alta: 15
- baja: 21
- media: 17
- urgente: 73. 检查一切正常工作
poetry run python src/mcp_server.py如果您看到没有错误的MCP服务器日志，您就准备好了！（按Ctrl+C停止）
______________________________________________________________________
⚙️ IDE光标设置
第一步：打开MCP配置
- 打开 光标
- Ve a 光标设置 （Cmd/Ctrl+，）
- 搜索标签 “MCP” 哦 “模型上下文协议”
- 点击 “编辑配置” 或直接打开配置文件
配置文件位置：
- macOS:
~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json - 视窗:
%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json - Linux:
~/.config/Cursor/User/globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
步骤2：添加服务器配置
将此设置粘贴到JSON文件中：
{
"mcpServers": {
"soporte-tecnico": {
"command": "bash",
"args": [
"-c",
"cd /RUTA/ABSOLUTA/A/mcp_henry_masterclass && poetry run python src/mcp_server.py"
]
}
}
}⚠️ 重要：示例 /RUTA/ABSOLUTA/A/mcp_henry_masterclass 在您的机器上显示该项目的实际路径。
要获得绝对路径：
# En la carpeta del proyecto, ejecuta:
pwd步骤3：重新启动光标
- 完全关闭光标
- 重新打开它
- 在光标中打开此项目
步骤 4: 检查连接
在光标聊天中，询问：
“您有什么MCP工具？”
您应该看到列出的技术支持服务器工具。
______________________________________________________________________
🎯 演示建议提示
提示1：基本探索
¿Cuántos tickets de soporte tenemos en total? Dame un resumen por prioridad y estado.目标：演示人工智能如何使用 obtener_estadisticas 概述。
______________________________________________________________________
提示2：特定过滤
Muéstrame todos los tickets urgentes que están abiertos. ¿Cuáles deberíamos atender primero?目标：查看如何使用 consultar_tickets 使用过滤器，然后分析结果。
______________________________________________________________________
提示3：趋势分析
¿Qué problemas técnicos son los más comunes según los tickets? Identifica los top 3 asuntos recurrentes.目标：演示对真实数据的分析能力，而无需传递整个数据集。
______________________________________________________________________
提示4：上下文搜索
Busca todos los tickets relacionados con "Error 500" o problemas de autenticación.
¿Hay algún patrón en los clientes afectados?目标显示 buscar_tickets_por_texto 交叉分析。
______________________________________________________________________
提示5：执行报告
Genera un reporte ejecutivo para management sobre el estado del sistema de soporte.
Incluye métricas clave, problemas críticos y recomendaciones.目标：能够以执行格式综合来自多个工具的数据。
______________________________________________________________________
🏗️ 项目架构
mcp_henry_masterclass/
│
├── src/ # Código fuente principal
│ └── mcp_server.py # Servidor MCP con 3 herramientas
│
├── scripts/ # Scripts de utilidades
│ └── setup_db.py # Generador de datos de prueba
│
├── tests/ # Tests del proyecto
│ └── __init__.py # Inicializador del paquete de tests
│
├── .gitignore # Exclusiones de Git (Python, Poetry, macOS, Cursor, Claude)
├── LICENSE # Licencia MIT
├── README.md # Este archivo
├── poetry.lock # Lock de dependencias (auto-generado)
├── pyproject.toml # Configuración de Poetry y metadatos del proyecto
│
└── soporte.db # Base de datos SQLite (generada con setup_db.py)可用的MCP工具
| 工具 | 描述 | 何时使用 |
|---|---|---|
consultar_tickets | 按优先级/状态过滤门票 | 搜索特定案例 |
obtener_estadisticas | 系统汇总 | 概述和指标 |
buscar_tickets_por_texto | 免费文本搜索 | 按关键字查找问题 |
______________________________________________________________________
🧪 测试手册
要在没有光标的情况下直接测试服务器：
# Instalar cliente MCP inspector
npm install -g @modelcontextprotocol/inspector
# Inspeccionar el servidor
mcp-inspector poetry run python src/mcp_server.py这将打开一个Web界面，您可以在其中手动测试工具。
______________________________________________________________________
📖 额外资源
______________________________________________________________________
🤝 贡献
这个项目是亨利大师班的教材。如果您发现改进或错误：
- 叉库
- 使用您的功能创建分支（
git checkout -b feature/mejora) - 提交您的更改(
git commit -m 'Añade nueva funcionalidad') - 推拉拉马(
git push origin feature/mejora) - 打开拉动请求
______________________________________________________________________
📝 许可证
麻省理工学院许可证-随时可以使用此代码进行学习和教学。
______________________________________________________________________
🎓 关于亨利
亨利 它是拉丁美洲领先的技术学校，培训世界级的全堆栈开发人员。
关于代码的问题？ 在课堂上联系我们或在GitHub上打开一个问题。
______________________________________________________________________
快乐编码！ 🚀