mgmt/tests/README.md

3.3 KiB
Raw Blame History

测试脚本目录

本目录包含了项目的所有测试脚本,按照功能进行了分类组织。

目录结构

tests/
├── mcp_servers/          # MCP服务器相关测试脚本
│   ├── test_direct_search.sh
│   ├── test_local_mcp_servers.sh
│   ├── test_mcp_interface.sh
│   ├── test_mcp_servers.sh
│   ├── test_mcp_servers_comprehensive.py
│   ├── test_mcp_servers_improved.py
│   ├── test_mcp_servers_simple.py
│   ├── test_qdrant_ollama_server.py
│   ├── test_qdrant_ollama_tools.sh
│   ├── test_qdrant_ollama_tools_fixed.sh
│   ├── test_search_documents.sh
│   └── test_mcp_search_final.sh
├── mcp_server_test_report.md  # MCP服务器测试报告
├── run_all_tests.sh       # 自动化测试运行器
└── legacy/               # 旧的或不再使用的测试脚本

MCP服务器测试脚本说明

Shell脚本

  • test_direct_search.sh: 测试search_documents方法通过SSH执行Python代码
  • test_local_mcp_servers.sh: 检查MCP配置测试服务器可用性context7, qdrant, qdrant-ollama验证环境变量
  • test_mcp_interface.sh: 通过实际接口测试MCP服务器调用包括tools/list和qdrant_search方法
  • test_mcp_servers.sh: 通过initialize方法调用测试Qdrant和Qdrant-Ollama MCP服务器
  • test_search_documents.sh: 添加测试文档并搜索"人工智能"artificial intelligence
  • test_qdrant_ollama_tools.sh: 通过JSON-RPC调用测试search_documents和add_document工具
  • test_qdrant_ollama_tools_fixed.sh: 测试search_documents、add_document和list_collections工具
  • test_mcp_search_final.sh: 最终版本的MCP搜索测试脚本

Python脚本

  • test_qdrant_ollama_server.py: 启动服务器,测试初始化、工具列表、文档添加和搜索功能
  • test_mcp_servers_comprehensive.py: 使用asyncio和增强响应处理综合测试MCP服务器
  • test_mcp_servers_improved.py: 改进版的MCP服务器测试使用asyncio和增强响应处理
  • test_mcp_servers_simple.py: 简化版MCP服务器测试使用同步子进程调用

使用方法

运行单个测试脚本

cd tests/mcp_servers
./test_local_mcp_servers.sh

或运行Python测试

cd tests/mcp_servers
python test_mcp_servers_simple.py

批量运行所有测试

使用自动化测试运行器脚本,可以一键运行所有测试并生成详细报告:

cd tests
./run_all_tests.sh

自动化测试运行器将:

  • 自动运行所有Shell和Python测试脚本
  • 彩色输出测试进度和结果
  • 生成详细的测试报告Markdown格式
  • 统计测试通过率和失败情况
  • 保存测试日志到文件

注意事项

  • 所有测试脚本都依赖于正确的环境变量配置
  • 测试前请确保相关服务context7, qdrant, qdrant-ollama已启动
  • 某些测试可能需要SSH访问权限

测试报告

mcp_server_test_report.md 文件包含了MCP服务器的详细测试结果包括

  • context7、qdrant和qdrant-ollama三个服务器的测试状态
  • 测试环境和方法说明
  • 发现的问题和解决方案
  • 环境变量配置详情
  • 建议和后续改进方向

建议在运行测试脚本前先阅读测试报告,了解当前的测试状态和已知问题。