AI导哈

AI连接协议

Model Context Protocol (MCP) 是一种连接AI助手与外部工具、数据源和服务的强大标准协议，提供统一接口实现AI与各种服务的交互。

  • by CuriousCaliBoi
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 CuriousCaliBoi/MCP_tutorial

使用说明

模型上下文协议（MCP）——完整教程

欢迎！本教程将向您介绍关于……的所有必要知识 模型上下文协议（MCP），这是一个强大的标准，用于将AI助手连接到外部工具、数据源和服务。

🎯 你将学到的内容

通过完成本教程，您将了解：

  • 什么是MCP以及它为何具有革命性
  • 核心架构和组件
  • 如何构建MCP服务器和客户端
  • 使用工具、资源和提示进行工作
  • 现实世界中的实际应用实施

📚 教程结构

本教程以循序渐进的学习路径组织：

概念理解

  1. 01_什么是MCP.md - MCP简介及其目的
  2. 02_核心概念.md - 架构、服务器、客户端、传输
  3. 03_mcp工具.md - 理解MCP工具（函数调用）
  4. 04_mcp资源.md - 了解MCP资源（数据访问）
  5. 05_mcp_提示.md - 理解MCP提示（提示模板）

实际实施

  1. simple_server.py 翻译为中文是：“简单服务器.py” 或者更自然地表达为 “简易服务器脚本.py” - 您的第一个MCP服务器
  2. calculator_server.py 翻译为中文是：“计算器服务器.py” - 构建基于工具的服务器
  3. file_server.py（文件服务器脚本） - 构建基于资源的服务器
  4. `mcp_client.py` 翻译为中文是：“MCP客户端.py” 或者更简洁地表述为 “MCP客户端脚本”。这里，“MCP”可能代表某个特定的系统、协议或客户端-服务器架构中的客户端部分，具体含义需根据上下文确定 - 作为客户端连接到MCP服务器
  5. mcp.py（文件名，可直译为“MCP.py”，在中文语境中通常保持原名不变） - 完整的端到端示例

🚀 开始使用

先决条件

  • Python 3.10 或更高版本
  • 对Python中async/await的基本理解
  • 熟悉JSON-RPC（有帮助但非必需）

安装

# Install required dependencies
pip install -r requirements.txt

快速入门

  1. 阅读这些概念 (文件01-05) 以了解MCP基础
  2. 运行示例 观看MCP的实际操作：
    # Start a simple server
python simple_server.py

# In another terminal, run the client
python mcp_client.py
  3. 实验 通过修改代码并构建你自己的服务器！

🎓 学习路径推荐

如果你是MCP的新手：

  • 从01_what_is_mcp.md开始
  • 仔细阅读02_core_concepts.md文件
  • 运行 simple_server.py 并检查代码
  • 通过其他示例继续推进

如果你有API使用经验：

  • 快速浏览01和02部分，以了解MCP相关的特定概念
  • 跳转到03、04、05以获取三个核心基本元素
  • 研究Python的实现
  • 为实际应用场景构建你自己的服务器

如果你通过实践学得最好：

  • 请阅读01_what_is_mcp.md以了解背景信息
  • 直接跳转到 simple_server.py
  • 根据需要参考概念文档
  • 大胆尝试，勇于创新！

🔑 关键概念概览

  • MCP 服务器向AI助手暴露工具、资源和提示
  • MCP客户端连接到服务器并利用其功能（通常是AI助手）
  • 工具AI可以调用的功能（如“搜索网络”或“读取文件”）
  • 资源AI可以访问的数据（如文件、数据库记录或API响应）
  • 提示带变量的可重用提示模板
  • 交通客户端和服务器如何通信（stdio、HTTP、WebSocket）

💡 为什么MCP很重要

在MCP（机器学习平台）出现之前，每个AI助手都需要为每个工具或数据源进行定制化的集成。MCP提供了一个 通用标准，意思是：

  • ✅ 一次编写，适用于任何兼容MCP的AI
  • ✅ 即插即用架构
  • ✅ 安全、标准化的通信
  • ✅ 可组合且可扩展

🛠️ 您将要构建的内容

完成本教程后，您将能够构建：

  • 一个配备数学工具的计算器服务器
  • 一个暴露资源的文件系统服务器
  • 一个能够连接到任何MCP服务器的客户端
  • 一个完整的综合示例

📖 额外资源

🎉 让我们开始吧！

开始你的旅程，首先打开（某物/某个应用等） 01_什么是MCP.md 让我们一起潜入模型上下文协议的奇妙世界吧！

记住：学习的最佳方式就是实践。不要只读——要运行代码，修改它，破坏它，然后重新构建它！

相关 MCP