AI导哈

模型上下文协议工作坊

一个关于如何安全使用、构建和贡献MCP服务器的6小时密集工作坊，MCP是连接AI应用程序与外部工具和数据源的新兴标准。

  • by Digital-Ethos-Academy
  • HTML
  • 本地部署
  • 更新于
在 GitHub 查看 Digital-Ethos-Academy/MCP-Workshop

使用说明

模型上下文协议研讨会

欢迎参加模型上下文协议（MCP）研讨会！这个6小时的密集研讨会将教你如何安全地使用、构建和贡献MCP服务器——这是将人工智能应用程序连接到外部工具和数据源的新兴标准。

工作坊概述

持续时间： 6小时（2个零件×3小时）
格式： 约80%的实践实验室，约20%的讲座
结构： 两个可独立推广的部分——取一个或两个！

第1部分：MCP基础和安全使用

目标受众： 所有希望在MCP中使用AI工具的员工
先决条件： 基本熟悉AI助手和开发工具

第2部分：构建和贡献安全MCP服务器

目标受众： 希望创建和贡献MCP服务器的开发人员
先决条件： Python经验（1-3年），第1部分或同等MCP理解

你将学到什么

第1部分：安全使用MCP

  • 了解MCP架构：服务器、客户端、主机和传输
  • 从Visa MCP Hub发现和使用MCP服务器
  • 使用Visa的安全框架评估MCP服务器的安全风险
  • 应用安全最佳实践：同意、授权、数据隐私

第二部分：构建与贡献

  • 使用FastMCP（Python SDK）构建自定义MCP服务器
  • 实施具有安全控制的工具、资源和提示
  • 应用RBAC、审计日志和输入验证
  • 向Visa MCP Hub提供生产就绪服务器

你将建造什么

第1部分： 安全评估技能和评估任何MCP服务器的检查表
第2部分： 功能齐全 安全文档助手MCP服务器 与：

  • 具有输入验证的搜索和检索工具
  • 使用RBAC控件记录资源
  • 全面的审计日志记录
  • 生产就绪错误处理

议程

第1部分：MCP基础和安全使用（3小时）

“发现、评估和安全使用Visa的MCP服务器”

时间 活动 描述
0:00-0:25 MCP介绍 架构、概念、与REST API的比较
0:25-0:45 Visa MCP中心概述 了解预构建的服务器、优势以及如何启用
0:45-1:15 实验1：使用MCP服务器 使用MCP服务器配置VS Code+GitHub Copilot
1:15-1:30 休息 -
1:30-2:15 MCP安全深潜 同意、授权、数据隐私、工具安全
2:15-2:45 实验2：安全评估 根据Visa安全标准评估MCP服务器
2:45-3:00 总结与问答 关键要点、安全讨论

第2部分：构建和贡献安全MCP服务器（3小时）

“构建生产就绪的MCP服务器，为Visa Hub做出贡献”

时间 活动 描述
0:00-0:15 回顾：MCP和安全 独立与会者快速回顾
0:15-0:30 构建您的第一台服务器 FastMCP基础、装饰、测试
0:30-1:15 实验3：您的第一台MCP服务器 使用FastMCP装饰器构建服务器
1:15-1:30 休息 -
1:30-2:00 高级模式和安全 异步工具、资源、RBAC、审计日志
2:00-2:45 实验4：安全文档助理 构建具有安全控制的完整服务器
2:45-3:00 为Visa MCP Hub做出贡献 最佳实践、提交流程、总结

仓库结构

MCP-Workshop/
├── README.md                         # This file
├── requirements.txt                  # Python dependencies
├── .env.example                      # Optional env template
├── check_environment.py              # Setup verification script
├── Labs/
│   ├── Part_1/
│   │   ├── README_Part_1.md          # Part 1 guide
│   │   ├── Lab_1_Using_MCP_Servers.ipynb
│   │   └── Lab_2_Security_Evaluation.ipynb
│   └── Part_2/
│       ├── README_Part_2.md          # Part 2 guide
│       ├── text_utility_server_starter.py
│       ├── Lab_3_Your_First_MCP_Server.ipynb
│       └── Lab_4_Secure_Document_Assistant.ipynb
├── Solutions/                        # Reference implementations
├── Slides/                           # Presentation decks
│   ├── Part_1_MCP_Foundations_Secure_Usage.html
│   └── Part_2_Building_Contributing.html
└── Supporting_Materials/
    ├── Environment_Setup_Guide.md
    ├── STUDENT_GUIDE.md
    ├── INSTRUCTOR_GUIDE.md
    ├── 04-MCP-Security.pdf
    └── 08-MCP Hub.pdf

入门指南

1.先决条件

  • Python 3.10+ （MCP SDK需要）
  • VS Code 使用GitHub Copilot扩展
  • Git 用于版本控制
  • Node.js/npx （用于运行MCP服务器 npx)

2.克隆存储库

git clone https://github.com/your-org/MCP-Workshop.git
cd MCP-Workshop

3.创建虚拟环境

python -m venv .venv
# macOS/Linux
source .venv/bin/activate
# Windows
.\.venv\Scripts\Activate.ps1

4.安装依赖项

pip install --upgrade pip
pip install -r requirements.txt

5.验证安装

# Test MCP CLI is installed
mcp version

# Run the full environment check
python check_environment.py

实验室概述

第一部分实验室

实验1：使用MCP服务器
使用VS Code和GitHub Copilot从Visa MCP Hub学习发现和使用MCP服务器。了解服务器配置和功能。

实验2：安全评估
应用Visa的安全框架来评估MCP服务器。练习识别风险、评估同意/授权流程和制定缓解策略。

第二部分实验室

实验3：您的第一台MCP服务器
使用FastMCP构建您的第一个MCP服务器。使用创建工具 @mcp.tool() 装饰师，与 mcp dev，并与MCP检查员进行测试。

实验4：安全文档助理
构建一个完整的、生产就绪的MCP服务器，具有安全控制，包括RBAC、审计日志、输入验证和错误处理。

关键资源

API成本估算

本次研讨会使用AI API。每个实验室的估计成本：

实验室 API调用 估计成本
实验1 5-10次工具调用 0.01-0.05美元
实验2 最低（评估练习） 0.00-0.02美元
实验室3 最低（本地测试） 0.00-0.02美元
实验4 10-15次工具调用 0.02-0.10美元
工作坊总计 ~ 30-40个电话 $0.05 - $0.20

注： 成本可能因型号选择和输入/输出长度而异。

故障排除

常见问题

问题： ModuleNotFoundError: No module named 'mcp'

  • 解决方案： 确保您的虚拟环境已激活并运行 pip install "mcp[cli]"

问题： MCP服务器无法启动

  • 解决方案： 检查你是否使用Python 3.10+ python --version

问题： VS Code无法识别MCP服务器

  • 解决方案： 在中配置MCP后重新启动VS代码 .vscode/mcp.json

看 Supporting_Materials/Environment_Setup_Guide.md 了解详细的故障排除。

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

相关 MCP