py-mcp-full

Полный набор инструментов для разработки парсеров PY — анализ киносайтов MacCMS + интеллектуальная генерация исходного кода + отладка селекторов + отладка ссылок на воспроизведение + тестирование интерфейсов + оценка соответствия стандартам кода + полные файловые операции

Основан на протоколе MCP (Model Context Protocol) и предоставляет AI-ассистентам программирования 18 профессиональных инструментов, охватывающих весь процесс разработки парсеров для киносайтов.

✨ Характеристики

• 🔍 Глубокий анализ структуры сайта — автоматическое распознавание MacCMS v8/v10/API сбора данных/нестандартных архитектур

• 🤖 Интеллектуальная генерация исходного кода — генерация парсеров T3/T4 в один клик на основе результатов анализа

• 🎯 Отладка селекторов — проверка результатов сопоставления XPath/CSS селекторов в реальном времени

• 🎬 Отладка ссылок на воспроизведение — рекурсивный разбор прямых ссылок m3u8/mp4, поддержка извлечения JS-переменных v8/v10

• 🧪 Тестирование интерфейсов — автоматизированное тестирование пяти основных интерфейсов (home/category/detail/search/play)

• 📋 Оценка стандартов — 12-критериальная взвешенная проверка исходного кода парсера

• 📁 Полные файловые операции — read/write/delete/mkdir/move/copy/info/cwd

🚀 Быстрый старт

Установка

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

Настройка MCP-клиента

Добавьте в конфигурацию MCP-клиента, такого как Claude Desktop / Cursor / Cherry Studio:

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

Переменная окружения ROOT указывает корневой каталог проекта парсера, файловые инструменты работают относительно этого пути.

Упрощенное развертывание (опционально)

Используйте esbuild для упаковки в один файл, без необходимости в node_modules:

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

Конфигурация после упаковки:

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

🛠 Список инструментов (18)

Инструменты разработки парсеров (10)

Инструменты файловых операций (8)

📖 Процесс использования

① 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="...")
   → 检查规范符合度

🏗 Структура проекта

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

Описание репозитория

Данный README предназначен только для описания основной информации о проекте и границ репозитория, предоставляется исключительно для технического обучения и обмена опытом, не содержит руководств по использованию, подключению или описания ресурсов.

Благодарности

Домашняя страница hjdhnx

📄 Лицензия

MIT