MCP Knowledge Base

🚀 MCP 知識庫

本知識庫圍繞模型上下文協議（MCP）構建，這是一個新興標準，旨在讓大語言模型（LLMs）通過結構化交互調用工具。本倉庫將詳細解釋 MCP 的通信流程、展示各組件間的交互，並提供模擬代碼，助力大家深入瞭解這一前沿技術。

🚀 快速開始

此倉庫是一個個人與公開的知識庫，圍繞 模型上下文協議 (MCP) 展開。MCP 是一個新興的標準，用於使大語言模型（LLMs）能夠通過結構化交互調用工具。目前它正在開發中，可能存在一些早期的解釋或概念空白，這些將在 MCP 發展過程中逐步完善。

✨ 主要特性

• 包含解釋 MCP 通信流程的內容。
• 有展示主機、服務器、LLM 和工具之間交互的圖表。
• 提供示例 Python 代碼，模擬 MCP 管道。
• 包含筆記和對論文或討論的引用。
• 是探索新想法的地方，如工具鏈、緩存和 MCP 中的狀態管理。

🔄 MCP 工作原理

以下是基於早期實驗的 MCP 生命週期簡要說明：

1. 💬 用戶輸入：用戶提出一個問題（例如，在 VS Code 或瀏覽器 IDE 中——這充當 MCP 主機）。
2. 📡 工具發現：主機向 MCP 服務器 發送請求，以發現可用工具或插件。
3. 📤 查詢分發：主機將用戶查詢和工具元數據傳遞給 LLM。
4. 🧠 工具選擇：LLM 選擇一個或多個工具來完成查詢（例如天氣 API 或計算器）。
5. 🛠️ 工具執行：主機通過調用 MCP 服務器來執行工具(s)。
6. 📥 結果處理：工具返回其結果；主機將其傳遞迴 LLM。
7. ✅ 最終輸出：LLM 以包含所有必要上下文的完整答案作出回應。

💻 使用示例

在 examples/ 文件夾中：

基礎用法

• basic_mcp_demo.py：將添加一個 MCP 主機和服務器通信的基本示例。

# 此處後續會添加 MCP 主機和服務器通信的基本示例代碼

高級用法

• tool_plugin_example.py：將演示工具註冊表和調用。

# 此處後續會添加工具註冊表和調用的演示代碼

• mcp_host_server_flow.py：將演示從用戶輸入到 LLM 響應的完整生命週期。

# 此處後續會添加從用戶輸入到 LLM 響應完整生命週期的演示代碼

🧱 概念與構建模塊

• 工具：外部服務（API、數據庫、函數），LLM 可以通過它們擴展自己的能力。
• 主機：LLM 運行和顯示結果的界面環境。
• 服務器：處理工具調用物流的中間件。
• 模式：用於結構化請求和響應的 JSON 模式或數據格式。
• 上下文處理：確保 LLM 能夠訪問之前的所有工具調用，以保持回答的連貫性。

📚 詳細文檔

✅ 建議倉庫結構

mcp-knowledge-base/
│
├── README.md
├── 圖表/
│   └──                       # 任何視覺解釋
├── examples/
│   ├── basic_mcp_demo.py
│   └── tool_plugin_example.py
├── mcp_host_server_flow.py
└── 資料夾/

注意事項：
1. 確保倉庫結構清晰，文件名和目錄名使用中文。
2. 每個文件夾應包含相關的內容，如示例代碼、文檔等。
3. README.md 應詳細說明倉庫內容和使用方法。

📁 相關項目和參考資料

• MCP 項目：鏈接
• LangChain 文檔：鏈接
• OpenAI 工具調用文檔：鏈接

此倉庫將不斷更新，以反映 MCP 的最新發展和相關資源。