Quick Example

🚀 使用 MCP 協議標準化與大語言模型（LLM）交互的服務器

本項目藉助 MCP 協議，為大語言模型（LLM）交互提供標準化方案。MCP 協議作為開放協議，統一了應用程序為大語言模型提供上下文的方式，為基於 LLM 的應用程序連接數據源、使用工具、執行標準提示搭建了統一框架。

🚀 快速開始

示例項目設置與安裝

1. 克隆倉庫：

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

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

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

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

# 安裝依賴項
uv sync

4. 運行客戶端和服務器：

python client.py mcp_server.py

✨ 主要特性

MCP 生態系統架構

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

• MCP 服務器：負責工具可用性（公開可用功能）、工具執行（運行請求的功能）、靜態內容作為資源（提供可引用的數據）、預設提示（常見任務的標準模板）。
• 客戶端：管理與服務器的連接、LLM 集成、組件之間的消息傳遞。
• 宿主：提供前端界面，向用戶展示 MCP 功能，是與整個生態系統的集成點。

MCP 服務器組件靈活性

MCP 服務器通過定義明確的接口公開標準化能力，宿主和客戶端可通過該協議標準連接到這些服務器。但如何將這些功能呈現給用戶仍然靈活且完全由開發者決定，開發者可自行設計實際實現和用戶體驗，可通過命令行界面、圖形應用程序，或嵌入在更大的系統中。

📚 詳細文檔

MCP 服務器主要組件

工具

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

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

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

資源

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

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

提示

提示是預定義的指令，用於指導 LLM 執行特定任務，可包括上下文信息、輸入參數等。