08-测试与调试

测试与调试

在开始测试你的 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 服务器实现。

界面示例如下：

你也可以以 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 请求调用工具，传递的负载包含工具名称及其参数。选择最适合你的方法。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 都有类似的测试章节，你可以根据所选运行环境进行调整。

示例

• Java 计算器
• .Net 计算器
• JavaScript 计算器
• TypeScript 计算器
• Python 计算器

额外资源

• Python SDK

接下来

• 下一步：部署

免责声明：
本文件由 AI 翻译服务 Co-op Translator 翻译而成。尽管我们力求准确，但请注意，自动翻译可能存在错误或不准确之处。原始文件的母语版本应被视为权威来源。对于重要信息，建议采用专业人工翻译。我们不对因使用本翻译而产生的任何误解或误释承担责任。