Quick MCP Example

🚀 使用 MCP 協議標準化與 LLM 交互的服務器通信

模型上下文協議（Model Context Protocol，MCP） 是一個開放協議，它統一了應用程序向大語言模型（LLM）提供上下文的方式。簡單來說，它為基於 LLM 的應用程序提供了統一框架，用於連接數據源、獲取上下文信息、使用工具以及執行標準提示語句。

MCP 生態系統定義了三個關鍵組件：

• MCP 服務器：負責處理工具可用性（公開可用功能）、工具執行（按需運行這些功能）、將靜態內容作為資源（提供可引用的數據）以及預設提示語句（用於常見任務的標準化模板）。
• 客戶端：管理與服務器的連接、LLM 集成以及組件之間的消息傳遞。
• 主機：提供用戶界面，向用戶展示 MCP 功能，同時也是與其他生態系統的集成點。

這種架構構建了一個模塊化系統，允許不同組件獨立開發，同時保持互操作性。這使用戶能夠構建針對不同 LLM 相關功能的 MCP 服務器，並在各種支持的應用程序中實現即插即用。MCP 常用於集成功能 API 和工具，或連接到本地數據源。

✨ 主要特性

• 提供統一框架，方便應用程序向大語言模型提供上下文。
• 模塊化架構，各組件可獨立開發且保持互操作性。
• 支持多種數據格式，可靈活配置大語言模型的行為。

📦 安裝指南

克隆倉庫

git clone https://github.com/ALucek/quick-mcp-example.git
cd quick-mcp-example

創建 ChromaDB 數據庫

按照 MCP_setup.ipynb 中的說明，創建向量數據庫並嵌入一個 PDF 文檔。

創建虛擬環境並安裝依賴項

# 使用 uv（推薦）
uv venv
source .venv/bin/activate  # macOS/Linux
# 或者
.venv\Scripts\activate     # Windows

# 安裝依賴項
uv sync

運行客戶端和服務器

python client.py mcp_server.py

💻 使用示例

基礎用法

工具定義

工具是 LLM 可以調用的功能，用於執行操作或檢索信息。每個工具的定義如下：

{
  name: string;          // 工具的唯一標識符
  description?: string;  // 人類可讀的描述
  inputSchema: {         // 工具參數的 JSON 模式
    type: "object",
    properties: { ... }  // 工具特定參數
  }
}

工具允許 LLM 與外部系統交互、執行代碼、查詢數據庫或進行計算。它們代表具有效果或生成新信息的操作。

資源定義

資源表示可以被客戶端應用程序訪問的數據源。它們通過唯一標識符進行識別，包括：

{
  uri: string;           // 資源的唯一標識符
  name: string;          // 人類可讀的名稱
  description?: string;  // 可選描述
  mimeType?: string;     // 可選 MIME 類型
}

資源可以是靜態內容或動態生成的內容。MCP 支持多種數據格式，包括文本文件、PDF 文檔和 JSON 數據。

提示符定義

提示符定義了 LLM 的行為模式。它們允許客戶端指定如何與 LLM 交互，例如：

• 指定輸入的處理方式
• 定義輸出格式
• 配置上下文信息

通過 MCP，客戶端可以靈活地配置 LLM 的行為，以滿足具體應用場景的需求。

📚 詳細文檔

MCP 服務器通過定義明確的接口公開標準化功能，構成了協議的基礎。主機和客戶端可以通過協議標準連接到這些服務器，但如何向用戶呈現這些功能仍然靈活且完全由開發者決定。也就是說，實際的實現和用戶體驗可以完全根據開發者的意願進行設計——無論是命令行界面、圖形化應用程序還是嵌入在更大的系統中。

在此指南中，我們將重點構建一個示例 MCP 服務器，包含核心功能，並附帶一個簡單的客戶端實現來演示交互模式。首先，讓我們概述 MCP 服務器的主要組件：

通過以上步驟，您可以快速搭建一個基於 MCP 協議的 LLM 交互系統。更多詳細信息，請參考相關文檔和示例代碼。