mgmt/tests/mcp_server_test_report.md

MCP服务器测试报告

测试概述

本报告记录了对context7、qdrant和qdrant-ollama三个MCP服务器的测试结果。

测试环境

• 测试时间：2025-06-17
• 测试方法：通过SSH连接到远程服务器进行测试
• 测试工具：JSON-RPC协议直接调用MCP服务器

测试结果

1. context7服务器

• 状态：✅ 正常工作
• 测试内容：
  • 成功初始化
  • 成功获取工具列表
  • 成功执行搜索功能
• 备注：context7服务器运行稳定，所有功能正常

2. qdrant-ollama服务器

• 状态：✅ 正常工作（已修复filter参数问题）
• 测试内容：
  • 成功获取工具列表：add_document、search_documents、list_collections和get_collection_info
  • 成功使用add_document工具添加文档
  • 成功使用search_documents工具搜索文档
• 修复记录：
  • 问题：search_documents工具使用filter参数时出现"Unknown arguments: ['filter']"错误
  • 原因：参数名称不匹配，工具定义中使用filter，但实现中使用query_filter
  • 解决方案：将工具定义中的filter参数名改为query_filter
  • 验证结果：修复后search_documents工具正常工作，不再出现错误

3. qdrant服务器

• 状态：✅ 正常工作
• 测试内容：
  • 成功获取工具列表：qdrant_search、qdrant_add和qdrant_delete
  • 成功使用qdrant_add工具添加文档
  • 成功使用qdrant_search工具搜索文档
• 备注：qdrant服务器运行稳定，所有功能正常

环境变量配置

两个服务器都正确配置了以下环境变量：

• QDRANT_URL: http://dev1:6333 (qdrant-ollama) / http://localhost:6333 (qdrant)
• QDRANT_API_KEY: 313131
• OLLAMA_URL: http://dev1:11434 (仅qdrant-ollama)
• OLLAMA_MODEL: nomic-embed-text (仅qdrant-ollama)
• COLLECTION_NAME: ollama_mcp (qdrant-ollama) / mcp (qdrant)

结论

所有三个MCP服务器均已成功测试并正常工作。qdrant-ollama服务器的filter参数问题已修复，不再出现"Unknown arguments: ['filter']"错误。所有服务器的核心功能（添加文档、搜索文档）均正常运行。

建议

1. 考虑将qdrant_mcp_server.py中的search方法更新为query_points方法，以消除弃用警告
2. 可以考虑为qdrant-ollama服务器添加更多过滤选项，增强搜索功能
3. 建议定期测试MCP服务器的功能，确保持续稳定运行