🚀 MCP-代码指导
mcp-code-guidance是一个使用 Python 语言从零开始学习 MCP 和 A2A 协议的教程。MCP（Model-Context Protocol）和 A2A（Agent-to-Agent）是大模型应用中两个重要的协议，分别侧重于智能体与外部工具的交互以及智能体之间的协作，本教程能帮助你快速掌握这两个协议的使用。
🚀 快速开始
介绍
mcp-code-guidance是一个使用 Python 语言从零开始学习 MCP 和 A2A 协议的教程。MCP（Model-Context Protocol）和 A2A（Agent-to-Agent）是大模型应用中两个重要的协议，分别侧重于智能体与外部工具的交互以及智能体之间的协作。
MCP 协议是一种用于模型与外部环境交互的协议，它允许模型通过 API 与外部环境进行通信，并获取外部环境的信息。MCP 协议的主要特点是：
- 支持多种外部环境，包括文本、图像、音频等。
- 支持多种模型，包括大模型、小模型等。
https://modelcontextprotocol.io/introduction
✨ 主要特性
- 提供使用 Python 从零开始学习 MCP 和 A2A 协议的教程。
- 涵盖多种 MCP 服务示例，如查询天气、查询股票等。
- 详细介绍 MCP 协议特点，支持多种外部环境和模型。
📦 安装指南
环境要求
- Python 3.10+
安装步骤
- 安装 uv
- 安装 uv 命令
curl -LsSf https://astral.sh/uv/install.sh | sh
install.sh 脚本执行时会从 github.com 下载 uv-aarch64-apple-darwin.tar.gz 并解压后安装。由于 github.com 网络不稳定，可以手动下载。这里提供一个技巧，可以通过启动本地 Python HTTP 临时服务来支持文件下载，同时修改 install.sh 脚本中的下载地址为本地服务地址。
python -m http.server 8181
调整后的 shell 脚本可以参考: 修改后的 uv-install.sh
- **添加用户本地 bin 目录到 PATH**
vi ~/.bash_profile
export PATH="$HOME/.local/bin:$PATH"
source ~/.bash_profile
- 初始化项目，以 mcp-server-01quickstart 为例
# 创建新项目目录
uv init mcp-server-01quickstart -p3.11
cd mcp-server-01quickstart
# 创建虚拟环境并激活它
uv venv
source .venv/bin/activate
# 安装依赖项
uv add "mcp[cli]" httpx
# 创建我们的服务文件
touch mcp-server-01quickstart.py
📚 详细文档
项目结构
mcp-code-guidance/
├── LICENSE
├── README.en.md
├── README.md
├── mcp-server-01quickstart # 最简单的 MCP 服务，仅包含工具
├── mcp-server-02weather # 查询天气的 MCP 服务
├── mcp-server-03stock # 查询股票的 MCP 服务
├── my-project
└── tutorial # MCP 和 A2A 开发教程