現在我們的 MCP 伺服器已經正常運作,是時候建構客戶端了。客戶端是讓我們的應用程式能夠與 MCP 伺服器通訊並存取其功能的元件。
了解客戶端架構
在深入程式碼之前,讓我們先釐清關於 MCP 專案的一個重點。通常您只會實作 MCP 客戶端或 MCP 伺服器其中一個,而不是兩者都做。我們在這個專案中同時建構兩者,只是為了讓您能看到它們如何協同運作。

MCP 客戶端由兩個主要元件協同運作組成:

- MCP 客戶端 - 我們建立的自訂類別,用於簡化 Session 的使用
- Client Session - 與伺服器的實際連線(屬於 MCP Python SDK 的一部分)
Client Session 處理低階的通訊工作,但在程式關閉時需要仔細地清理資源。這就是為什麼我們將其包裝在自己的類別中——以便自動管理那些清理工作。
客戶端在我們應用程式中的角色
還記得我們的應用程式流程圖嗎?客戶端在兩個關鍵時刻扮演著至關重要的角色:

我們的 CLI 程式碼使用客戶端來:
- 取得可用工具的清單以傳送給 Claude
- 在 Claude 請求時執行工具
實作核心客戶端函式
讓我們來實作這兩個必要的函式:list_tools 和 call_tool。
對於 list_tools,我們需要連接到我們的 Session 並請求可用的工具:
async def list_tools(self) -> list[types.Tool]:
result = await self.session().list_tools()
return result.tools對於 call_tool,我們將工具名稱和輸入參數傳遞給伺服器:
async def call_tool(
self, tool_name: str, tool_input: dict
) -> types.CallToolResult | None:
return await self.session().call_tool(tool_name, tool_input)就是這樣!Session 會為我們處理所有複雜的通訊細節。
測試客戶端
客戶端檔案的底部包含一個簡單的測試工具。您可以直接執行它來驗證一切是否正常運作:
uv run mcp_client.py這會連接到您的 MCP 伺服器並印出可用的工具。您應該會看到顯示工具定義的輸出,包括名稱、描述和輸入結構描述(input schemas)。
重要的結構描述差異
這裡有一個您需要知道的陷阱:MCP 工具定義並不完全符合 Claude 所預期的格式。MCP 規範有自己的工具結構描述(tool schemas)格式,這與 Bedrock 所要求的格式略有不同。
別擔心——專案中已經有處理這種轉換的程式碼了。core/bedrock.py 中的 to_bedrock_tools 函式會將 MCP 工具定義轉譯成 Claude 能理解的格式。
與 Claude 進行測試
現在伺服器和客戶端都已經正常運作,您可以測試完整的流程了。試著執行您的主要應用程式,並請 Claude 讀取一份文件:
uv run main.py然後詢問:「report.pdf 文件的內容是什麼?」
Claude 將會:
- 從您的客戶端接收可用工具的清單
- 決定使用 read_doc_contents 工具
- 您的客戶端將在 MCP 伺服器上執行該工具
- Claude 將接收文件內容並做出回應
客戶端作為您的應用程式程式碼與 MCP 伺服器之間的橋樑,讓您能輕鬆地將伺服器的功能公開給 Claude 以及系統的其他部分使用。