Skip to content

Latest commit

 

History

History
161 lines (108 loc) · 6.35 KB

README.md

File metadata and controls

161 lines (108 loc) · 6.35 KB

測試與除錯

在開始測試你的 MCP 伺服器之前，了解可用的工具和除錯的最佳實務非常重要。有效的測試能確保你的伺服器如預期運作，並幫助你快速找出並解決問題。以下章節將說明驗證 MCP 實作的建議方法。

概述

本課程將介紹如何選擇合適的測試方法及最有效的測試工具。

學習目標

完成本課程後，你將能夠：

  • 描述各種測試方法。
  • 使用不同工具有效地測試你的程式碼。

測試 MCP 伺服器

MCP 提供工具協助你測試與除錯伺服器：

  • MCP Inspector：一個可作為 CLI 工具或視覺化工具執行的命令列工具。
  • 手動測試：你可以使用 curl 等工具發送網路請求，任何能執行 HTTP 的工具都適用。
  • 單元測試：你可以使用喜歡的測試框架來測試伺服器和客戶端的功能。

使用 MCP Inspector

我們在之前的課程中已介紹過此工具的使用方式，這裡簡單說明。它是用 Node.js 建置的工具，你可以透過執行 npx 指令來使用，該指令會暫時下載並安裝工具，執行完請求後會自動清理。

MCP Inspector 可協助你：

  • 發現伺服器功能：自動偵測可用的資源、工具和提示
  • 測試工具執行：嘗試不同參數並即時查看回應
  • 檢視伺服器元資料：查看伺服器資訊、結構與設定

工具的典型執行方式如下：

npx @modelcontextprotocol/inspector node build/index.js

上述指令會啟動 MCP 及其視覺化介面，並在瀏覽器中開啟本地網頁介面。你會看到一個儀表板，顯示已註冊的 MCP 伺服器、可用工具、資源和提示。此介面讓你能互動式測試工具執行、檢查伺服器元資料並查看即時回應，方便驗證與除錯 MCP 伺服器實作。

介面大致長這樣： Inspector

你也可以用 CLI 模式執行此工具，只要加上 --cli 參數。以下是以 CLI 模式執行並列出伺服器上所有工具的範例：

npx @modelcontextprotocol/inspector --cli node build/index.js --method tools/list

手動測試

除了使用 inspector 工具測試伺服器功能外，另一種類似的方法是使用能執行 HTTP 的客戶端，例如 curl。

使用 curl，你可以直接透過 HTTP 請求測試 MCP 伺服器：

# Example: Test server metadata
curl http://localhost:3000/v1/metadata

# Example: Execute a tool
curl -X POST http://localhost:3000/v1/tools/execute \
  -H "Content-Type: application/json" \
  -d '{"name": "calculator", "parameters": {"expression": "2+2"}}'

從上述 curl 用法可見，你是用 POST 請求呼叫工具，並以包含工具名稱及參數的 payload 傳送。請選擇最適合你的方式。CLI 工具通常使用較快，且易於撰寫腳本，對 CI/CD 環境特別有用。

單元測試

為你的工具和資源撰寫單元測試，確保它們如預期運作。以下是範例測試程式碼。

import pytest

from mcp.server.fastmcp import FastMCP
from mcp.shared.memory import (
    create_connected_server_and_client_session as create_session,
)

# Mark the whole module for async tests
pytestmark = pytest.mark.anyio


async def test_list_tools_cursor_parameter():
    """Test that the cursor parameter is accepted for list_tools.

    Note: FastMCP doesn't currently implement pagination, so this test
    only verifies that the cursor parameter is accepted by the client.
    """

 server = FastMCP("test")

    # Create a couple of test tools
    @server.tool(name="test_tool_1")
    async def test_tool_1() -> str:
        """First test tool"""
        return "Result 1"

    @server.tool(name="test_tool_2")
    async def test_tool_2() -> str:
        """Second test tool"""
        return "Result 2"

    async with create_session(server._mcp_server) as client_session:
        # Test without cursor parameter (omitted)
        result1 = await client_session.list_tools()
        assert len(result1.tools) == 2

        # Test with cursor=None
        result2 = await client_session.list_tools(cursor=None)
        assert len(result2.tools) == 2

        # Test with cursor as string
        result3 = await client_session.list_tools(cursor="some_cursor_value")
        assert len(result3.tools) == 2

        # Test with empty string cursor
        result4 = await client_session.list_tools(cursor="")
        assert len(result4.tools) == 2

上述程式碼做了以下事情：

  • 使用 pytest 框架，讓你能以函式撰寫測試並使用 assert 陳述式。
  • 建立一個包含兩個不同工具的 MCP 伺服器。
  • 使用 assert 陳述式檢查特定條件是否成立。

你可以參考完整檔案

根據上述檔案，你可以測試自己的伺服器，確保功能如預期建立。

所有主要 SDK 都有類似的測試章節，你可以依照所選的執行環境做調整。

範例

其他資源

接下來

免責聲明：
本文件係使用 AI 翻譯服務 Co-op Translator 進行翻譯。雖然我們致力於確保翻譯的準確性，但請注意，自動翻譯可能包含錯誤或不準確之處。原始文件的母語版本應視為權威來源。對於重要資訊，建議採用專業人工翻譯。我們不對因使用本翻譯而產生的任何誤解或誤釋負責。