Seann0824/movies-search-mcp
3.2
If you are the rightful owner of movies-search-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A smart movie and TV series resource search tool built on Model Context Protocol (MCP), supporting multiple video source searches and link validation.
Tools
search_movie
Search for movie or TV series resources.
validate_video_url
Validate the playability of video links.
🎬 Movies Search Tool
一个智能的电影和电视剧资源搜索工具,基于 Model Context Protocol (MCP) 构建,支持多个视频源搜索和链接验证。
✨ 特性
- 🔍 多源搜索: 支持多个视频网站资源搜索
- ✅ 链接验证: 自动验证视频链接的可播放性
- 🚀 MCP 协议: 完全兼容 Model Context Protocol
- 📡 双模式支持: STDIO 和 SSE (Server-Sent Events) 两种传输模式
- 🛠️ 易于集成: 可作为 MCP 工具集成到 AI 应用中
📦 安装
全局安装
npm install -g @acwink/movies-search-mcp
使用 npx (推荐)
# 默认 STDIO 模式
npx @acwink/movies-search-mcp
# SSE 模式
npx @acwink/movies-search-mcp --sse
🚀 使用方法
命令行使用
# 默认 STDIO 模式 (适合 MCP 客户端)
movies-search-mcp
# SSE 模式 (适合 Web 应用)
movies-search-mcp --sse
# 指定端口 (仅 SSE 模式)
PORT=3001 movies-search-mcp --sse
MCP 客户端集成
将此工具添加到你的 MCP 客户端配置中:
{
"mcpServers": {
"movies-search-mcp": {
"command": "npx",
"args": ["@acwink/movies-search-mcp"]
}
}
}
可用工具
1. search_movie
搜索电影或电视剧资源
// 搜索电影
{
"title": "阿凡达",
"type": "movie"
}
// 搜索电视剧
{
"title": "权力的游戏",
"type": "tv",
"season": 1,
"episode": 1
}
2. validate_video_url
验证视频链接的可播放性
// 单个链接验证
{
"url": "https://example.com/video/123"
}
// 批量验证
{
"url": [
"https://example.com/video/123",
"https://example.com/video/456"
]
}
🔧 开发
本地开发
# 克隆项目
git clone https://github.com/Seann0824/movies-search-mcp.git
cd movies-search-mcp
# 安装依赖
npm install
# 开发模式
npm run dev:cli # STDIO 模式
npm run dev:cli:sse # SSE 模式
# 构建
npm run build
# 测试
npm test
项目结构
src/
├── cli.ts # CLI 入口文件
├── mcp-server.ts # STDIO MCP 服务器
├── mcp-server-sse.ts # SSE MCP 服务器
├── sources/ # 视频源实现
├── core/ # 验证器实现
├── types/ # 类型定义
└── utils/ # 工具函数
🌐 API 端点 (SSE 模式)
当使用 SSE 模式时,服务器会启动以下端点:
GET /sse
- 建立 SSE 连接POST /messages
- 发送 JSON-RPC 消息GET /health
- 健康检查
📄 许可证
MIT License
🤝 贡献
欢迎提交 Issue 和 Pull Request!
📞 支持
如果你遇到任何问题,请:
- 查看 Issues
- 创建新的 Issue
- 联系作者:
⭐ 如果这个项目对你有帮助,请给个 Star!