py-mcp-full

PY Spider-Entwicklungs-Tool-Suite — MacCMS-Film-Site-Analyse + Intelligente Quellcode-Generierung + Selektor-Debugging + Play-Link-Debugging + API-Tests + Code-Standard-Bewertung + Vollständige Dateivorgänge

Basierend auf dem MCP (Model Context Protocol)-Protokoll bietet es 18 professionelle Tools für KI-Programmierassistenten, die den gesamten Entwicklungsprozess von Film-Spidern abdecken.

✨ Funktionen

• 🔍 Tiefenanalyse der Website-Struktur — Automatische Erkennung von MacCMS v8/v10/Sammel-API/Nicht-Standard-Architekturen

• 🤖 Intelligente Quellcode-Generierung — Generierung von T3/T4-Spider-Quellen mit einem Klick basierend auf Analyseergebnissen

• 🎯 Selektor-Debugging — Echtzeit-Validierung von XPath/CSS-Selektor-Übereinstimmungen

• 🎬 Play-Link-Debugging — Rekursive Analyse von m3u8/mp4-Direktlinks, unterstützt v8/v10 JS-Variablenextraktion

• 🧪 API-Tests — Automatisierte Tests für die fünf Haupt-APIs (home/category/detail/search/play)

• 📋 Standard-Bewertung — 12 gewichtete Prüfungen für Spider-Quellcode-Standards

• 📁 Vollständige Dateivorgänge — read/write/delete/mkdir/move/copy/info/cwd

🚀 Schnellstart

Installation

git clone https://github.com/sunniu-hjdhnx/py-mcp-full.git
cd py-mcp-full
npm install

MCP-Client konfigurieren

Fügen Sie in der Konfiguration von MCP-Clients wie Claude Desktop / Cursor / Cherry Studio Folgendes hinzu:

{
  "mcpServers": {
    "py_mcp_full": {
      "command": "node",
      "args": ["/path/to/py-mcp-full/index.js"],
      "env": {
        "ROOT": "/path/to/your/spider/project"
      }
    }
  }
}

Die Umgebungsvariable ROOT gibt das Stammverzeichnis des Spider-Quellprojekts an; Dateivorgänge basieren auf diesem Pfad.

Schlanke Bereitstellung (optional)

Verwenden Sie esbuild, um es in eine einzelne Datei zu packen, ohne dass node_modules erforderlich sind:

npm install -g esbuild
esbuild index.js --bundle --platform=node --format=cjs --target=node22 --outfile=dist/index.cjs

Konfiguration nach dem Packen:

{
  "mcpServers": {
    "py_mcp_full": {
      "command": "node",
      "args": ["dist/index.cjs"],
      "env": { "ROOT": "/path/to/your/spider/project" }
    }
  }
}

🛠 Tool-Liste (18)

Spider-Entwicklungstools (10)

Dateivorgangstools (8)

📖 Nutzungsprozess

① analyze_website(url="https://example.com")
   → 识别CMS类型，获取HTML结构参数

② debug_selector(url="...", selector="//div[contains(@class,'item')]")
   → 验证选择器是否正确

③ create_spider_source(url="...", mode="T4")
   → 生成完整爬虫源代码

④ test_interface(source_code="...", interface="all")
   → 测试五大接口是否正常

⑤ evaluate_source(source_code="...")
   → 检查规范符合度

🏗 Projektstruktur

py-mcp-full/
├── index.js          # 主程序（1409行）
├── package.json      # 依赖配置
├── manifest.json     # 工具 Schema 定义
└── 使用说明.md        # 中文详细文档

Repository-Hinweise

Diese README dient nur zur Erläuterung der grundlegenden Projektinformationen und Repository-Grenzen. Sie dient ausschließlich dem technischen Austausch und enthält keine Anleitungen zur Nutzung, Integration oder Ressourcenbeschreibungen.

Danksagung

hjdhnx Homepage

📄 Lizenz

MIT