mgmt/tests/mcp_server_test_report.md

55 lines
2.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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服务器的功能确保持续稳定运行