Zhiwen Assistant MCP

# 智文助手增强版部署说明 ## 版本信息 - 版本: 2.0.0 - 部署日期: 2025-12-18 - 更新内容: 集成安全验证、配置管理、性能监控等优化特性 ## 部署步骤 ### 自动部署（推荐） 1. **运行部署脚本** ```cmd cd "e:\skills技能\我的MCP服务器" 部署脚本.bat ``` 2. **等待部署完成** - 脚本会自动检查环境、依赖、配置 - 运行集成测试确保功能正常 - 启动MCP服务器 ### 手动部署 1. **环境准备** ```cmd # 检查Python版本（需要3.8+） python --version # 激活虚拟环境（如使用） mcp-env\Scripts\activate ``` 2. **依赖安装** ```cmd pip install mcp fastmcp pydantic pyyaml ``` 3. **配置检查** ```cmd # 检查配置文件 python -c "from config import get_config_manager; print('配置正常')" ``` 4. **集成测试** ```cmd python test_integration.py ``` 5. **启动服务器** ```cmd python enhanced_folder_docs_mcp.py ``` ## 功能特性 ### 🔒 安全验证 - 路径安全性检查 - 敏感信息检测 - 文件类型验证 - 目录结构验证 ### ⚙️ 配置管理 - YAML/JSON配置文件支持 - 配置验证和默认值处理 - 动态配置重载 - 环境特定配置 ### 🚀 性能优化 - 智能缓存机制 - 并发操作控制 - 性能监控和统计 - 资源使用优化 ### 📊 监控系统 - 结构化日志记录 - 操作审计跟踪 - 错误收集和分析 - 性能指标监控 ## 配置文件说明 主配置文件: `mcp_config.yaml` ### 服务器配置 ```yaml server: name: "文件夹文档生成MCP服务器" version: "2.0.0" transport: "stdio" # 支持: stdio, http port: 8080 # HTTP模式下的端口号 ``` ### 功能选项 ```yaml options: exclude_dirs: # 排除的目录 - ".git" - "__pycache__" - "node_modules" force_update: false # 强制更新（忽略缓存） output_file: "folder_structure_mindmap.md" max_depth: 10 # 最大扫描深度 include_hidden: false # 是否包含隐藏文件 ``` ### 安全配置 ```yaml security: allowed_paths: [] # 允许的路径 enable_security_validation: true scan_sensitive_content: true block_dangerous_files: true ``` ### 性能配置 ```yaml performance: cache_ttl: 3600 # 缓存生存时间（秒） max_concurrent_operations: 5 # 最大并发操作数 enable_performance_monitoring: true ``` ## 常见问题解决 ### 1. 导入错误 ``` ImportError: cannot import name 'xxx' ``` **解决**: 检查依赖包是否正确安装 ```cmd pip install mcp fastmcp pydantic pyyaml ``` ### 2. 配置文件错误 ``` ConfigValidationError: 配置验证失败 ``` **解决**: 检查mcp_config.yaml文件格式和内容 ### 3. 权限问题 ``` PermissionError: 无权限访问目录 ``` **解决**: 检查目标目录的访问权限，或调整安全配置 ### 4. 缓存问题 ``` 缓存操作失败 ``` **解决**: 清空缓存或调整缓存配置 ## 监控和维护 ### 日志文件 - 位置: `mcp_server.log` - 级别: INFO, WARNING, ERROR ### 缓存管理 ```python # 清空缓存 from enhanced_folder_docs_mcp import cache cache.clear() # 获取缓存统计 stats = cache.get_stats() print(stats) ``` ### 配置重载 ```python # 重载配置 from config import reload_config reload_config() ``` ## 联系支持 如遇到问题，请检查： 1. 部署日志文件 2. 服务器日志 3. 集成测试结果 4. 配置文件内容 --- **部署完成后，您将拥有一个功能强大、安全可靠的增强版MCP服务器！**