增加每章节 README 文件

2026-09-22 15:57:59 +08:00
parent 8e86665096
commit 9445061c76
49 changed files with 3815 additions and 6 deletions
@@ -0,0 +1,55 @@
+# MCP 协议与工具接入
+
+> 所属：阶段四 · 工具生态与外围组件集成
+> 目标：理解 MCP 协议定位、最小实战把工具暴露成 MCP Server，以及 Agent 接入 MCP 客户端。
+
+---
+
+## 📌 学习目的
+
+理解 MCP 协议定位、最小实战把工具暴露成 MCP Server，以及 Agent 接入 MCP 客户端。
+
+## ✅ 学习要求（前置条件）
+
+已完成「01_tool_calling_ecosystem」+ 阶段三「02_langgraph_core」。
+
+## 📚 主要学习内容
+
+- 为什么需要 MCP：N×M 集成爆炸 → 一套标准协议
+- 核心概念：Host / Client / Server 与三大原语（tools / resources / prompts）
+- 传输与部署：stdio（本地） / Streamable HTTP（远程）
+- 最小实战：用 FastMCP 把工具工厂的工具暴露成 MCP Server
+- Agent 接入 MCP：LangChain / OpenAI Agents SDK
+
+## 📖 对应 docs
+
+- 目录：[`docs/04-阶段四-工具生态与外围组件集成/`](../../docs/04-阶段四-工具生态与外围组件集成/)（按目录名里的 `第 X 篇` 对应）
+- 在 docs 目录里找到对应的小点 markdown 文件阅读详细理论。
+
+## 🛠️ 建议练习
+
+- [ ] 用 FastMCP 把一个搜索工具暴露成 MCP Server
+- [ ] 用 LangChain MCP 客户端接入并调用
+- [ ] 对比 MCP 与工具工厂的分工
+
+## 🏁 完成后达成标准
+
+- [ ] 能用 FastMCP 暴露一个最小 MCP Server
+- [ ] 能解释 MCP 三大原语与安全边界
+- [ ] 能判断什么场景该上 MCP、什么场景继续用工具工厂
+
+---
+
+## 🚀 运行提示
+
+```bash
+# 激活根目录的虚拟环境
+cd /Users/jack/source/Demo/py/demo_python_agent
+source .venv/bin/activate   # 或直接用 uv run ...
+
+# 进入本章目录
+cd code/004_phase4_tool_ecosystem/04_mcp_protocol
+
+# 跑你的练习文件
+uv run python your_exercise.py
+```