🚀 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+

安装步骤

1. 安装 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

2. 初始化项目，以 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 开发教程