MCP电影下载服务器
MCP(模型上下文协议)服务器,用于从moviesdale.com搜索和下载泰米尔语电影。该服务器提供智能电影搜索,具有模糊匹配、拼写检查、年份过滤和自动广告链接检测功能。
特性
- 🔍 智能电影搜索:模糊匹配与拼写错误名称的拼写检查
- 📅 年份筛选:按上映年份搜索电影或从查询中自动检测年份
- 🎬 多种质量选项:360p、720p、1080p格式的下载链接
- 🚫 广告过滤:自动检测和过滤广告链接
- 📊 比赛得分:按与搜索查询的相似性排序的结果
- 💾 智能缓存:缓存电影列表以获得更好的性能
安装
先决条件
- Python 3.10或更高版本
uv包管理器(推荐)或pip
再进行
# Create virtual environment
uv venv
# Activate virtual environment
source .venv/bin/activate # Linux/macOS
# or
.venv\Scripts\activate # Windows
# Install dependencies
uv pip install -e .配置
适用于克劳德桌面
将此配置添加到您的Claude Desktop配置文件中:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json\ 视窗: %APPDATA%\Claude\claude_desktop_config.json\ Linux: ~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"movie-download": {
"command": "python",
"args": ["/path/to/MCP--Movie-Download/main.py"]
}
}
}适用于IV(或其他MCP客户)
在MCP客户端的配置文件中配置服务器:
- 命令:
python - 参数:
["/path/to/MCP--Movie-Download/main.py"]
可用工具
1. search_movie
通过自动拼写检查和年份过滤按名称搜索电影。
参数:
name(字符串,必填):要搜索的电影名称year(字符串,可选):发布年份过滤器(例如“2024”)limit(整数,可选):返回的最大结果(默认值:10)
示例:
Search for "Parasakthi 2026"2. list_years
从moviesda15.com获取所有可用的年份类别。
示例:
List all available years3. get_movies_by_year
列出特定年份的所有电影。
参数:
year(string,必填):从中获取电影的年份
示例:
Get all movies from 20254. get_movie_details
获取详细信息,包括特定电影的下载链接。
参数:
movie_url(字符串,必填):电影页面的URL
示例:
Get details for https://moviesda15.com/parasakthi-2026-tamil-movie/5. spell_check_movie
获取电影名称的拼写建议。
参数:
name(字符串,必填):要检查的电影名称year(字符串,可选):按年份筛选建议
示例:
Check spelling for "Sivaji"使用示例
示例1:搜索电影
User: "Search for Parasakthi 2026"
Response:
Found 1 movie(s) matching 'parasakthi':
1. Parasakthi (2026)
Match Score: 95%
URL: https://moviesda15.com/parasakthi-2026-tamil-movie/示例2:获取电影详细信息
User: "Get details for that movie"
Response:
Movie Details:
Title: Parasakthi (2026)
URL: https://moviesda15.com/parasakthi-2026-tamil-movie/
Download Links:
360P:
• 360p Mp4 HD Download: [link]
720P:
• 720p Mp4 HD Download: [link]
1080P:
• 1080p HD Download: [link]示例3:错播电影搜索
User: "Search for Sivaji moive" (misspelled)
Response:
Found 1 movie(s) matching 'sivaji':
1. Sivaji (2007) Original DVDRip
Match Score: 88%
URL: https://moviesda15.com/sivaji-2007-tamil-movie/建筑
项目结构
MCP--Movie-Download/
├── main.py # MCP server implementation
├── scraper.py # Web scraping utilities
├── search.py # Search and fuzzy matching
├── pyproject.toml # Project dependencies
├── .python-version # Python version
└── README.md # This file组件
main.py:带有工具定义和处理程序的MCP服务器scraper.py:HTTP请求、HTML解析、广告检测search.py:模糊匹配、拼写检查、年份提取
法律声明
\[!重要\] 此工具从moviesdale.com抓取内容。请确保您在您所在的司法管辖区拥有访问和使用此内容的合法权利。本软件的作者不对任何误用负责。
故障排除
服务器无法启动
- 确保已安装Python 3.10+:
python --version - 安装依赖项:
uv pip install -e . - 检查MCP客户端日志是否有错误
未找到电影
- 网站可能已关闭或结构已更改
- 检查互联网连接
- 网站URL可能已更改
速率限制/响应缓慢
- 刮刀包括内置的速率限制(请求之间延迟0.5秒)
- 大年度搜索可能需要时间,因为它们会获取多个页面
贡献
这是一个工作实施。要改进:
- 为大型结果集添加分页支持
- 实施更稳健的错误处理
- 添加单元测试
- 支持其他电影网站
许可证
本项目按原样提供,用于教育目的。
