Ailab Workshop On MCP

研讨会：使用FastMCP的模型上下文协议（MCP）

欢迎来到 模型上下文协议（MCP） 使用 FastMCP本课程将教你如何创建MCP服务器，并使用LangGraph将其与智能代理连接起来。

🎯 你将学到什么？

本次研讨会将从MCP基础开始，指导你构建一个能够消费MCP服务的完整LangGraph代理：

• MCP基础它是什么，为何存在，以及使用案例
• FastMCP用于创建MCP服务器的现代框架
• 工具和资源函数作为工具的展示
• 与LangGraph的集成使用 langchain-mcp-adapters
• 最终项目通过MCP查询保单的保险公司代理

📋 工作坊结构

模块1：MCP简介

MCP协议的基本概念、历史及使用案例。

• 01-fundamentos/README.md - 理论和概念
• 01-fundamentos/ejemplo_simple.py - 首个MCP服务器

模块2：FastMCP基础

使用基本工具创建MCP服务器。

• 02-fastmcp-basico/README.md - FastMCP指南
• 02-fastmcp-basico/servidor_math.py - 数学运算服务器
• 02-fastmcp-basico/test_servidor.py - 服务器测试

模块3：高级工具

复杂工具、验证和错误处理。

• 03-herramientas-avanzadas/README.md - 先进概念
• 03-herramientas-avanzadas/servidor_texto.py - 文本处理
• 03-herramientas-avanzadas/servidor_validaciones.py - 数据验证

模块4：资源与提示

展示静态数据和可重用的提示。

• 04-recursos-prompts/README.md - MCP资源和提示
• 04-recursos-prompts/servidor_recursos.py - 资源丰富的服务器
• 04-recursos-prompts/servidor_prompts.py - 带提示符的服务器

模块5：数据库

与数据库交互的MCP服务器。

• 05-base-datos/README.md - 与SQLite集成
• 05-base-datos/servidor_db.py - 带数据库的服务器
• 05-base-datos/init_db.py - 数据初始化

模块6：LangChain MCP工具

将MCP服务器与LangChain和LangGraph集成。

• 06-langchain-integration/README.md - 融入指南
• 06-langchain-integration/cliente_simple.py - 基本客户
• 06-langchain-integration/agente_simple.py - 配备MCP的代理

模块7：最终项目

使用LangGraph的完整代理，用于消费保险公司MCP服务器。

• 07-proyecto-final/README.md - 项目指南
• 07-proyecto-final/servidor_seguros.py - 保险MCP服务器
• 07-proyecto-final/agente_seguros.py - LangGraph代理
• 07-proyecto-final/api_rest.py 代理REST API
• 07-proyecto-final/test_agente.py - 全面测试

模块8（可选）：现有MCP服务器

学习使用社区现有的MCP服务器。

• 08-mcps-existentes/README.md - 完整指南
• 08-mcps-existentes/crear_db_ejemplo.py - 创建数据库
• 08-mcps-existentes/cliente_sqlite_mcp.py - 基础客户
• 08-mcps-existentes/agente_sqlite_mcp.py - 配备SQLite MCP的代理
• 08-mcps-existentes/ejemplo_multi_servidor.py - 多个服务器

🚀 先决条件

知识

• 中级Python（类、async/await、装饰器）
• REST API的基本概念
• 熟悉大型语言模型（LLMs）（非必需，但建议掌握）

软件

• Python 3.10或更高版本
• 代码编辑器（推荐使用VS Code）
• 使用Postman或curl进行测试

下属部门/分支机构

# Crear entorno virtual
python -m venv venv

# Activar entorno (Windows)
venv\Scripts\activate

# Instalar dependencias base
pip install -r requirements.txt

# Para el Módulo 8 (opcional): instalar Node.js para servidores npm
# Descarga desde: https://nodejs.org/

📚 学习方法论

1. 阅读README文件 每个模块的讲解以理解理论为目的
2. 运行示例 以便观察概念在实际中的应用
3. 修改代码 为了尝试和学习
4. 完成练习 在每个模块末尾提出

⏱️ 预计时长

• 阅读与理论2-3小时
• 通过实例练习3-4小时
• 最终项目2-3小时
• 总计8-10小时

建议分2-3次完成该研讨会。

🎓 进度等级

🟢 初级水平

• 完成模块1-3
• 理解MCP的基本概念
• 使用工具创建简单服务器

🟡 中级水平

• 完成第1-5模块
• 与MCP集成数据库
• 处理验证和错误

🔴 高级水平

• 完成所有模块
• 使用MCP构建LangGraph代理
• 提供完整的REST API

💎 额外等级（可选）

• 模块8：使用现有的MCP服务器
• 结合多个MCP服务器
• 为MCP生态系统做出贡献

📖 额外资源

官方文件

• 模型上下文协议
• FastMCP 文档
• LangChain MCP适配器
• LangGraph 文档

社区

• LangChain 社区

🛠️ 文件结构

mcp-workshop/
├── README.md                          # Este archivo
├── requirements.txt                   # Dependencias del workshop
├── 01-fundamentos/
│   ├── README.md
│   └── ejemplo_simple.py
├── 02-fastmcp-basico/
│   ├── README.md
│   ├── servidor_math.py
│   └── test_servidor.py
├── 03-herramientas-avanzadas/
│   ├── README.md
│   ├── servidor_texto.py
│   └── servidor_validaciones.py
├── 04-recursos-prompts/
│   ├── README.md
│   ├── servidor_recursos.py
│   └── servidor_prompts.py
├── 05-base-datos/
│   ├── README.md
│   ├── servidor_db.py
│   └── init_db.py
├── 06-langchain-integration/
│   ├── README.md
│   ├── cliente_simple.py
│   └── agente_simple.py
├── 07-proyecto-final/
│   ├── README.md
│   ├── servidor_seguros.py
│   ├── agente_seguros.py
│   ├── api_rest.py
│   └── test_agente.py
└── 08-mcps-existentes/          # Módulo opcional
    ├── README.md
    ├── INICIO-RAPIDO.md
    ├── crear_db_ejemplo.py
    ├── cliente_sqlite_mcp.py
    ├── agente_sqlite_mcp.py
    └── ejemplo_multi_servidor.py

🚦 快速启动

1. 初始设置

# Clonar o descargar el workshop
cd mcp-workshop

# Crear entorno virtual
python -m venv venv
venv\Scripts\activate

# Instalar dependencias
pip install -r requirements.txt

2. 配置API密钥

Crea un archivo .env 在根目录下使用你的Google API密钥：

GOOGLE_API_KEY=tu_api_key_aqui

在以下位置获取你的API密钥： Google AI Studio（谷歌人工智能工作室）

3. 第一个例子

# Ir al módulo 1
cd 01-fundamentos

# Ejecutar primer servidor MCP
python ejemplo_simple.py

💡 工作坊小贴士

• 体验修改示例以理解其工作原理
• 阅读评论代码已编写文档说明，以便学习
• 不要跳过模块概念是逐步构建起来的
• 使用调试器设置断点以理解程序流程
• 查阅文档资源链接是你的最佳伙伴

🌟 可选模块8

El（在西班牙语中通常作为冠词或代词使用，但单独出现时，根据上下文可能翻译为“那”、“他/她/它”等，此处无具体上下文，故保留原样或根据具体语境翻译） 模块8 这是可选的，但强烈推荐。它将教会你：

• 使用社区现有的MCP服务器
• 连接到官方MCP SQLite服务器
• 将多个服务器组合到一个代理中
• 利用MCP生态系统，无需编写服务器代码

优点：

• 节省时间，使用经过验证的解决方案
• 学习成熟的实施案例
• 访问数百种现有集成

首先： 08-mcps-existentes/INICIO-RAPIDO.md

🤝 支持

这个研讨会是AI实验室材料的一部分。如有疑问或问题：

1. 查看特定模块的README文件
2. 查阅FastMCP的官方文档
3. 在MCP的GitHub讨论区中搜索

______________________________________________________________________

准备好了吗？ 前往 01-fundamentos/README.md 开始你的MCP之旅。