SDK兼容性测试工具

MCP兼容性测试仪

此工具有助于检查来自不同MCP Python SDK版本的服务器和客户端是否相互兼容。

概述

MCP兼容性测试仪允许您：

1. 在隔离的虚拟环境中安装多个版本的MCP SDK
2. 测试不同SDK版本之间的客户端-服务器兼容性
3. 跨版本矩阵运行兼容性测试
4. 生成包含测试结果的报告

脚本

add_version.sh

在其自己的虚拟环境中安装特定的MCP SDK版本。

./add_version.sh <mcp-version>

例子：

./add_version.sh 1.2.1

这在中创建了一个虚拟环境 venvs/1.2.1/ 安装了指定的MCP版本。

check_versions.sh

测试特定客户端版本和服务器版本之间的兼容性。

./check_versions.sh <client-version> <server-version>

例子：

./check_versions.sh 1.3.0.rc1 1.2.1

此测试使用MCP 1.3.0.rc1的客户端是否可以成功地与使用MCP 1.2.1的服务器通信。

check_matrix.sh

对所提供版本的所有组合运行兼容性测试。

./check_matrix.sh <version1> [version2] [version3] ...

例子：

./check_matrix.sh 1.2.1 1.3.0.rc1

这将测试所有四种组合：

• 客户端1.2.1与服务器1.2.1
• 客户端1.2.1与服务器1.3.0.rc1
• 客户端1.3.0.rc1与服务器1.2.1
• 客户端1.3.0.rc1与服务器1.3.0.rcl

结果保存在 results/ 目录：

• 单个测试日志另存为 results/client_<version>_server_<version>.log
• 摘要报告生成如下 results/summary_<timestamp>.txt

测试实施

兼容性测试：

1. 初始化客户端和服务器之间的会话
2. 列出可用的工具、资源和提示
3. 为每个调用示例方法
4. 报告成功或失败

工作流示例

# Run the compatibility matrix test (this will automatically add the versions if not present)
./check_matrix.sh 1.2.1 1.3.0.rc1

# Check the results
cat results/summary_*.txt

这将显示哪些版本组合是兼容的，哪些是失败的。