Everything Search MCP Server - Optimized Version
    
一个经过全面优化的MCP服务器，提供跨Windows、macOS和Linux的快速文件搜索功能，具备企业级安全增强和遵循MCP最佳实践的性能改进。
🎯 优化版本亮点
🔧 修复的关键问题
- 🐛 原始项目Issue #14修复: 解决了引号字符串查询失败问题，现在提供清晰的错误提示
- 🔒 空查询安全漏洞: 修复了空查询可能暴露系统文件的安全风险
- ⚡ 性能瓶颈: 优化了大结果集处理和响应时间
- 🔄 错误处理不一致: 统一了跨平台错误处理机制
🚀 新增核心功能
- 🛡️ 智能安全过滤: 自动检测和阻止敏感文件访问（密码、系统文件等）
- 🔍 高级查询验证: 实时输入验证，防止恶意或格式错误的查询
- 📊 MCP优化响应: 专为AI模型消费优化的结构化响应格式
- 🎛️ 环境变量配置: 支持灵活的SDK路径配置和部署选项
🏗️ 架构级实现
- 🔐 多层安全架构: 输入验证 → 关键词过滤 → 结果筛选 → 响应清理
- ⚡ 快速失败验证: 1kb",
"max_results": 20, "windows_params": { "match_path": true, "sort_by": 14, "match_case": false } }
### 安全搜索示例// ✅ 安全查询 - 正常执行 { "query": "document.pdf", "max_results": 10 }
// ❌ 被阻止的查询 - 安全拒绝 { "query": "password", "max_results": 10 } // 返回: "Query contains restricted keywords"
## 📋 API 参考
### 请求参数
| 参数 | 类型 | 描述 | 默认值 | 验证规则 |
|------|------|------|--------|----------|
| `query` | string | 搜索查询字符串 | 必需 | 非空，无敏感关键词 |
| `max_results` | integer | 最大结果数量 | 100 | 1-1000 |
| `match_path` | boolean | 匹配完整路径 | false | - |
| `match_case` | boolean | 区分大小写 | false | - |
| `match_regex` | boolean | 启用正则表达式 | false | - |
| `sort_by` | integer | 排序方式 (Windows) | 1 | 1-26 |
### 响应格式{ "path": "/完整/文件/路径", "filename": "文件名.扩展名", "extension": "扩展名", "size": 1024, "created": "2025-08-10T12:00:00Z", "modified": "2025-08-10T12:00:00Z", "accessed": "2025-08-10T12:00:00Z" }
### 错误响应// 输入验证错误 "Empty query not allowed" "Query contains restricted keywords" "Quoted string queries not supported"
// 系统错误 "Search failed: [具体错误信息]" "Platform not supported: [平台名称]"
## 🧪 测试和验证
### 运行测试套件运行所有测试
python -m pytest tests/ -v
运行安全测试
python -m pytest tests/test_mcp_security_fixes.py -v
运行 Issue #14 测试
python -m pytest tests/test_issue_14_spaces.py -v
性能基准测试
python tests/benchmark_performance.py
### 手动验证测试基本功能
echo '{"query": "*.txt", "max_results": 5}' | python -m mcp_server_everything_search
测试安全过滤
echo '{"query": "password", "max_results": 5}' | python -m mcp_server_everything_search
测试 Issue #14 修复
echo '{"query": "\"test file\"", "max_results": 5}' | python -m mcp_server_everything_search
## 📚 文档资源
- 📖 **[快速开始指南](QUICK_START.md)** - 5分钟快速设置
- 🔍 **[搜索语法指南](SEARCH_SYNTAX.md)** - 跨平台搜索语法详解
- 🛡️ **[MCP最佳实践](MCP_BEST_PRACTICES_IMPLEMENTATION.md)** - 技术实现详解
- 📊 **[测试报告](TESTING_REPORT.md)** - 完整测试结果和发现
- 📝 **[变更日志](CHANGELOG.md)** - 详细的改进和修复记录
- 📋 **[项目状态](PROJECT_STATUS.md)** - 生产就绪状态评估
## 🤝 贡献指南
### 开发环境设置git clone https://github.com/Colton-wq/mcp-everything-search-optimized.git cd mcp-everything-search-optimized
安装开发依赖
pip install -e ".[dev]"
运行代码质量检查
black src/ tests/ isort src/ tests/ flake8 src/ tests/ pyright src/ tests/
### 提交规范
- 🐛 `fix:` 修复bug
- ✨ `feat:` 新功能
- 🔒 `security:` 安全改进
- 📚 `docs:` 文档更新
- 🧪 `test:` 测试相关
- ⚡ `perf:` 性能优化
## 📄 许可证和致谢
### 许可证
本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件。
### 致谢
- **原始项目**: [mamertofabian/mcp-everything-search](https://github.com/mamertofabian/mcp-everything-search)
- **Everything SDK**: [voidtools](https://www.voidtools.com/) 提供的强大搜索引擎
- **MCP协议**: [Anthropic](https://github.com/modelcontextprotocol) 的模型上下文协议
### 优化版本贡献
- 🔒 **安全架构设计**: 多层安全验证和过滤机制
- ⚡ **性能优化**: AI消费模式优化和响应时间改进
- 🛠️ **MCP合规**: 完整的最佳实践实现
- 📚 **文档完善**: 企业级文档和使用指南
## 📞 支持和反馈
- 🐛 **问题报告**:
- 💬 **功能讨论**:
- 📧 **安全问题**: 请通过私有渠道报告安全漏洞
- 📖 **文档问题**: 欢迎提交文档改进建议
---
**🎯 优化版本目标**: 提供企业级安全性、AI优化性能和生产就绪质量的文件搜索MCP服务器。
**📈 版本状态**: v1.0.0 - 生产就绪，完整功能，安全强化