MCP Code Guidance

🚀 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 開發教程