项目日志1系统环境部署总结目录一、环境配置工具选择uv 包管理工具介绍uv 安装步骤二、项目结构与依赖安装项目整体结构各模块依赖安装三、环境变量配置服务器配置API密钥配置四、目录结构规划包结构设计模块划分五、常见问题与解决方案依赖安装问题会话管理问题其他常见问题六、部署验证服务启动验证功能测试验证团队信息组号73组项目AI社交媒体运营方案负责人程岩小组成员程岩阚荣至尚弘毅一、环境配置工具选择uv 包管理工具介绍uv 是一款基于 Rust 开发的高性能 Python 包管理与环境管理工具具备以下特点高性能执行速度远超传统 pip、venv、poetry 等工具自动环境管理虚拟环境自动管理无需手动创建和激活依赖安装与版本锁定确保项目依赖的一致性全平台支持可在 Windows、macOS、Linux 等平台使用极快极简零配置操作简单便于在容量较小的计算机上运行选择 uv 作为环境配置工具主要看重其高性能和易用性能够快速搭建开发环境保障团队环境一致性实现项目依赖的高效管理。uv 安装步骤在 Windows 系统上安装 uv 的步骤如下# 使用 PowerShell 安装 uvpowershell-cirm https://astral.sh/uv/install.ps1 | iex# 验证安装是否成功uv--version安装完成后uv 会自动添加到系统 PATH 中可在任何命令行窗口中直接使用。二、项目结构与依赖安装项目整体结构小红书 MCP 系统采用分层模块化架构整体结构如下┌─────────────────────────────────────────────────────────┐ │ AI Social Scheduler (智能调度层) │ │ - AI决策引擎 │ │ - 事件监听器 │ │ - 任务调度器 │ │ - 策略管理器 │ └───┬──────────┬──────────┬──────────┬──────────┬────────┘ │ MCP协议 │ MCP协议 │ MCP协议 │ MCP协议 │ MCP协议 ↓ ↓ ↓ ↓ ↓ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │xhs-content │ │xhs-image-mcp │ │xhs-video-mcp │ │xhs-browser- │ │xhs-data- │ │generator │ │(图像生成) │ │(视频生成) │ │automation-mcp │ │collector-mcp │ │ │ │ │ │ │ │(平台操作) │ │(数据收集) │ │- 内容生成 │ │- 图像生成 │ │- 视频脚本生成 │ │- 内容发布 │ │- 数据收集 │ │- 文案创作 │ │- Prompt模板 │ │- TTS语音合成 │ │- 内容搜索 │ │- 数据分析 │ │ │ │- Resource │ │- 视频合成 │ │- 用户互动 │ │- 趋势识别 │ └──────────────┘ └──────────────┘ └──────────────┘ │- 账户管理 │ └──────────────┘ └────────┬────────┘ │ 浏览器自动化 ↓ ┌──────────┐ │ 小红书平台 │ └──────────┘各模块依赖安装使用 uv 为各个模块安装依赖的步骤如下# 进入图像生成模块目录并安装依赖cde:\实验\项目实习\xiaohongshu-mcp-python-master\xhs-image-mcpuv sync# 进入视频生成模块目录并安装依赖cde:\实验\项目实习\xiaohongshu-mcp-python-master\xhs-video-mcpuv sync# 进入内容生成模块目录并安装依赖cde:\实验\项目实习\xiaohongshu-mcp-python-master\xhs-content-generator-mcpuv sync# 进入浏览器自动化模块目录并安装依赖cde:\实验\项目实习\xiaohongshu-mcp-python-master\xhs-browser-automation-mcpuv sync# 安装 Playwright 浏览器uv run playwright install chromium# 进入数据收集模块目录并安装依赖cde:\实验\项目实习\xiaohongshu-mcp-python-master\xhs-data-collector-mcpuv sync# 进入智能调度模块目录并安装依赖cde:\实验\项目实习\xiaohongshu-mcp-python-master\ai_social_scheduleruv sync每个模块的依赖安装过程会自动处理依赖关系确保所有必需的包都被正确安装。三、环境变量配置服务器配置在各模块目录下创建.env文件配置服务器相关参数# 服务器配置 MCP_HOST127.0.0.1 MCP_PORT8003使用127.0.0.1作为主机地址确保服务仅在本机上访问提高安全性。API密钥配置以图像生成模块为例配置 API 密钥# 通义万相配置图像生成 WANT2I_API_KEYyour_api_key WANT2I_BASE_URLhttps://dashscope.aliyuncs.com/compatible-mode/v1不同模块需要配置相应的 API 密钥例如内容生成模块可能需要配置 OpenAI、阿里云百炼或 Gemini 的 API 密钥视频生成模块可能需要配置视频合成服务的 API 密钥浏览器自动化模块可能需要配置小红书登录相关的参数四、目录结构规划包结构设计采用分层架构的目录结构设计符合工业界标准xiaohongshu_mcp_python/ # 包根目录 ├── __init__.py # 包入口统一接口暴露与兼容性处理 ├── main.py # 程序入口命令行主函数 ├── server/ # Web服务模块 │ ├── __init__.py │ ├── app.py # Flask服务实例初始化 │ ├── mcp.py # MCP核心实例封装 │ ├── mcp_tools.py # MCP工具函数登录、发布、搜索等 │ └── server_run.py # Web服务启动逻辑 ├── services/ # 核心业务服务层 │ ├── __init__.py │ └── XiaohongshuService.py # 封装MCP底层接口统一业务逻辑 ├── managers/ # 资源管理层 │ ├── __init__.py │ └── user_session_manager.py # 登录会话管理创建、校验、清理 ├── tests/ # 测试目录 │ ├── __init__.py │ ├── test_login.py # 登录功能测试 │ ├── test_publish.py # 内容发布测试 │ └── test_search.py # 内容检索测试 ├── requirements.txt # 依赖管理 └── pyproject.toml # 包构建配置模块划分server 模块负责 Web 服务的启动和管理提供 HTTP 接口services 模块封装核心业务逻辑处理 MCP 底层接口调用managers 模块管理资源如用户会话、配置等tests 模块包含单元测试确保功能的正确性每个子目录都必须添加空的__init__.py文件确保 Python 识别为可导入模块。五、常见问题与解决方案依赖安装问题问题使用 pip 安装依赖时速度慢容易出现超时解决方案使用 uv 包管理工具其执行速度远快于 pip能够快速完成依赖安装问题依赖版本冲突解决方案使用 uv 的版本锁定功能确保依赖版本的一致性在 pyproject.toml 中明确指定依赖版本定期更新依赖确保兼容性会话管理问题问题多线程调用时会话信息被覆盖解决方案在会话增删改查方法中添加 threading.Lock()确保同一时间仅一个线程操作会话字典# managers/user_session_manager.pyimportthreading _session_lockthreading.Lock()_user_sessions{}defcreate_session(user_id):with_session_lock:session_idstr(uuid.uuid4())_user_sessions[session_id]{user_id:user_id,token:,create_time:time.time(),expire_seconds:7200}returnsession_id问题会话过期判断逻辑错误未过期会话被误判为过期解决方案修正时间对比逻辑确保正确判断会话是否过期其他常见问题问题Playwright 浏览器安装失败解决方案使用uv run playwright install chromium命令安装确保网络连接稳定问题环境变量未生效解决方案确保 .env 文件放置在正确的目录下重启服务后环境变量会自动加载问题端口被占用解决方案修改 .env 文件中的 MCP_PORT 配置使用未被占用的端口六、部署验证服务启动验证启动各模块服务验证服务是否正常运行# 启动图像生成服务cde:\实验\项目实习\xiaohongshu-mcp-python-master\xhs-image-mcpuv run python-m server.server_run# 启动内容生成服务cde:\实验\项目实习\xiaohongshu-mcp-python-master\xhs-content-generator-mcpuv run python-m server.server_run# 启动浏览器自动化服务cde:\实验\项目实习\xiaohongshu-mcp-python-master\xhs-browser-automation-mcpuv run python-m server.server_run# 启动智能调度服务cde:\实验\项目实习\xiaohongshu-mcp-python-master\ai_social_scheduleruv run python-m api.app服务启动后可通过访问 http://localhost:端口 查看服务状态。功能测试验证运行测试脚本验证核心功能是否正常# 运行测试cde:\实验\项目实习\xiaohongshu-mcp-python-masteruv run pytest测试通过后说明环境部署成功系统可以正常运行。总结通过使用 uv 包管理工具我们成功搭建了小红书 MCP 系统的开发环境实现了各模块的依赖安装和配置。采用分层架构的目录结构设计确保了代码的高内聚低耦合便于团队协作和后续维护。环境部署过程中我们解决了依赖安装、会话管理等常见问题确保了系统的稳定性和可靠性。通过服务启动验证和功能测试确认了环境部署的成功。这套环境配置方案为后续的系统开发和功能扩展奠定了坚实的基础能够支持小红书 MCP 系统的全流程自动化运营需求。