🚀 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:
- 您可以直接从聊天室查询您的数据库
- 可以通过分析实际数据生成报告
- 您可以根据当前的体系结构建议代码
- 您可以自动化连接到您系统的任务
______________________________________________________________________
## 🛠️ 项目设置
### 先决条件
- Python 3.12+
- 诗歌instalado(安装指南)
- 光标IDE(在这里下载)
### 1.安装依赖项```bash
poetry install
这将安装:
mcp:MCP协议库fastmcp:轻松创建MCP服务器的框架
2.生成测试数据库```bash
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: 7
3. 检查一切正常工作```bash
poetry run python src/mcp_server.py
如果您看到没有错误的MCP服务器日志,您就准备好了!(按Ctrl+C停止)
______________________________________________________________________
## ⚙️ IDE光标设置
### 第一步:打开MCP配置
1. 打开 **光标**
1. Ve a **光标设置** (Cmd/Ctrl+,)
1. 搜索标签 **“MCP”** 哦 **“模型上下文协议”**
1. 点击 **“编辑配置”** 或直接打开配置文件
**配置文件位置:**
- **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文件中:```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 在您的机器上显示该项目的实际路径。
要获得绝对路径:```bash
En la carpeta del proyecto, ejecuta:
pwd
### 步骤3:重新启动光标
1. 完全关闭光标
1. 重新打开它
1. 在光标中打开此项目
### 步骤 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` |免费文本搜索|按关键字查找问题|
______________________________________________________________________
## 🧪 测试手册
要在没有光标的情况下直接测试服务器:```bash
# Instalar cliente MCP inspector
npm install -g @modelcontextprotocol/inspector
# Inspeccionar el servidor
mcp-inspector poetry run python src/mcp_server.py
这将打开一个Web界面,您可以在其中手动测试工具。
📖 额外资源
- MCP官方文件
- FASTMCP存储库
- MCP服务器示例
- 游标IDE文档
🤝 贡献
这个项目是亨利大师班的教材。如果您发现改进或错误:
- 叉库
- 使用您的功能创建分支(
git checkout -b feature/mejora) - 提交您的更改(
git commit -m 'Añade nueva funcionalidad') - 推拉拉马(
git push origin feature/mejora) - 打开拉动请求
📝 许可证
麻省理工学院许可证-随时可以使用此代码进行学习和教学。
🎓 关于亨利
亨利 它是拉丁美洲领先的技术学校,培训世界级的全堆栈开发人员。
关于代码的问题? 在课堂上联系我们或在GitHub上打开一个问题。
快乐编码! 🚀
