Claude Academy
載入中

存取資源

第 54 課10 分鐘

MCP 中的資源允許您的伺服器公開可直接包含在提示中的資料，而不需要透過工具呼叫來存取資訊。這為向像 Claude 這樣的 AI 模型提供上下文創造了一種更有效率的方式。

了解資源請求

當您在 MCP 伺服器上定義了資源後，您的客戶端需要一種方式來請求和使用它們。客戶端充當您的應用程式與 MCP 伺服器之間的橋樑，自動處理通訊和資料解析。

流程很簡單：當使用者想要引用一份文件時（例如輸入「@report.pdf」），您的應用程式會使用 MCP 客戶端從伺服器擷取該資源，並將其內容直接包含在傳送給 Claude 的提示中。

實作資源讀取

核心功能需要在您的 MCP 客戶端中有一個 read_resource 函式。此函式接受一個識別要擷取哪個資源的 URI 參數：

python
async def read_resource(self, uri: str) -> Any:
    result = await self.session().read_resource(AnyUrl(uri))
    resource = result.contents[0]

來自 MCP 伺服器的回應包含一個 contents 清單。您通常只需要第一個元素，其中包含實際的資源資料以及像 MIME 類型這樣的元資料。

處理不同的內容類型

資源可以回傳不同類型的內容，因此您的客戶端需要適當地解析它們。MIME 類型會告訴您如何處理資料：

python
if isinstance(resource, types.TextResourceContents):
    if resource.mimeType == "application/json":
        return json.loads(resource.text)
    
    return resource.text

這種方法確保 JSON 資源被正確解析為 Python 物件，而純文字資源則以字串形式回傳。MIME 類型作為您判斷正確解析策略的提示。

必要的匯入

為了讓這個功能正常運作，您需要在 MCP 客戶端中加入以下匯入：

python
import json
from pydantic import AnyUrl

json 模組處理 JSON 回應的解析，而 AnyUrl 則確保 URI 參數有正確的類型處理。

測試資源存取

實作完成後，您可以透過您的 CLI 應用程式測試此功能。當您輸入類似「What's in the @report.pdf document?」這樣的內容時，系統應該會：

  • 在自動完成清單中顯示可用的資源
  • 允許您選擇一個資源
  • 自動擷取資源內容
  • 將該內容包含在傳送給 Claude 的提示中

關鍵優勢在於 Claude 直接在提示中收到文件內容，無需透過工具呼叫來存取資訊。這使得互動更快速、更有效率。

與您的應用程式整合

請記住，您撰寫的 MCP 客戶端程式碼會被應用程式的其他部分使用。read_resource 函式成為一個建構區塊，其他元件可以呼叫它來擷取文件內容、列出可用資源，或將資源資料整合到提示中。

這種關注點分離讓您的程式碼保持整潔：MCP 客戶端負責處理與伺服器的通訊，而您的應用程式邏輯則專注於如何有效地使用這些資料。