py-mcp-full

PY 爬虫开发全量工具集 — MacCMS 影视站分析 + 智能源码生成 + 选择器调试 + 播放链接调试 + 接口测试 + 代码规范评估 + 全量文件操作

基于 MCP (Model Context Protocol) 协议，为 AI 编程助手提供 18 个专业工具，覆盖影视爬虫开发全流程。

✨ 特性

• 🔍 网站结构深度分析 — 自动识别 MacCMS v8/v10/采集API/非标架构
• 🤖 智能源码生成 — 基于分析结果一键生成 T3/T4 爬虫源
• 🎯 选择器调试 — 实时验证 XPath/CSS 选择器匹配结果
• 🎬 播放链接调试 — 递归解析 m3u8/mp4 直链，支持 v8/v10 JS 变量提取
• 🧪 接口测试 — 五大接口（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 客户端

在 Claude Desktop / Cursor / Cherry Studio 等 MCP 客户端的配置中添加：

{
  "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个）

工具	功能	必要参数
analyze_website	深度分析网站结构，识别CMS类型	url
create_spider_source	智能生成爬虫源代码	url
debug_selector	验证CSS选择器匹配结果	url, selector
debug_play_link	递归调试播放链接提取	url
test_interface	测试五大接口	source_code, interface
evaluate_source	评估代码规范符合度	source_code
fetch_url	抓取页面内容	url
edit_file	替换文件内容	path, search_text, replace_text
find_in_file	搜索文件内容	path, keyword
list_directory	列出目录内容	path

文件操作工具（8个）

工具	功能	必要参数
read_file	读取文件（支持分段）	path
write_file	写入文件（覆盖/追加）	path, content
delete_file	删除文件或目录	path
create_directory	创建目录（支持递归）	path
move_file	移动/重命名	source, destination
copy_file	复制文件	source, destination
file_info	获取文件详细信息	path
get_cwd	获取工作目录	—

📖 使用流程

① 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的主页

📄 License

MIT