Przeglądaj źródła

docs: Add MCP server startup guide and fix dependencies

- Upgrade torch to >=2.6.0 for CVE-2025-32434 fix
- Add chardet to requirements.txt
- Create scripts/start_mcp_server.sh startup script
- Add container restart guide to CLAUDE.md
- Fix PYTHONPATH for MCP server startup

Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
d8dfun 2 dni temu
rodzic
commit
7e7a7f1c86
3 zmienionych plików z 59 dodań i 1 usunięć
  1. 39 0
      CLAUDE.md
  2. 2 1
      requirements.txt
  3. 18 0
      scripts/start_mcp_server.sh

+ 39 - 0
CLAUDE.md

@@ -105,3 +105,42 @@
 
 - [ ] 阶段 5:Sprint 规划与开发 (Phase 2-7)
 - [ ] 阶段 6:测试与部署
+
+---
+
+## 📦 容器重启后操作指南
+
+> **⚠️ 重要**:开发容器重启后,需要执行以下步骤才能正常使用 MCP 服务器和翻译功能。
+
+### 步骤 1:启动 MCP 服务器
+
+```bash
+# 使用启动脚本(推荐)
+./scripts/start_mcp_server.sh
+```
+
+### 步骤 2:验证服务器状态
+
+```bash
+# 检查进程和日志
+ps aux | grep mcp_server
+tail -f mcp.log
+```
+
+### 步骤 3:外层重新配置 MCP 连接
+
+在本地(外层)执行:
+```bash
+/root/.local/bin/claude mcp remove novel-translator
+/root/.local/bin/claude mcp add --scope project --transport http \
+  novel-translator \
+  https://d8d-ai-vscode-8080-223-236-template-6-group.dev.d8d.fun/sse
+```
+
+### 🔧 依赖问题修复
+
+| 问题 | 解决方案 |
+|------|----------|
+| chardet 缺失 | `pip3 install --break-system-packages chardet` |
+| torch 安全漏洞 | 已升级到 2.6.0 |
+| PYTHONPATH 错误 | 启动脚本已自动设置 |

+ 2 - 1
requirements.txt

@@ -5,7 +5,7 @@
 transitions==0.9.0
 
 # Translation (ML models)
-torch==2.5.1
+torch>=2.6.0
 transformers==4.49.0
 sentencepiece==0.2.1
 
@@ -16,6 +16,7 @@ pytest-cov==4.1.0
 # Utilities
 pyyaml==6.0.1
 requests==2.31.0
+chardet>=5.0.0
 
 # UI (PyQt6 for Epic 7b)
 PyQt6==6.8.0

+ 18 - 0
scripts/start_mcp_server.sh

@@ -0,0 +1,18 @@
+#!/bin/bash
+# 启动 Novel Translator MCP 服务器
+
+cd /mnt/code/223-236-template-6
+
+# 设置 PYTHONPATH
+export PYTHONPATH=/mnt/code/223-236-template-6:$PYTHONPATH
+
+# 停止旧的 MCP 服务器
+pkill -f 'mcp_server' 2>/dev/null
+sleep 2
+
+# 启动 MCP 服务器
+echo "Starting MCP Server..."
+nohup python3 -m src.mcp_server.server > mcp.log 2>&1 &
+
+sleep 3
+echo "MCP Server started. Check logs: tail -f mcp.log"