Movies Search Tool

🎬 Movies Search Tool

Una herramienta inteligente de búsqueda de recursos de películas y series, construida sobre el Protocolo de Contexto de Modelo (MCP), que admite búsqueda en múltiples fuentes de video y verificación de enlaces.

✨ Características

• 🔍 Búsqueda multi-fuente: Admite búsqueda de recursos en múltiples sitios de video
• ✅ Verificación de enlaces: Verifica automáticamente la reproducibilidad de los enlaces de video
• 🚀 Protocolo MCP: Totalmente compatible con Model Context Protocol
• 📡 Soporte de doble modo: Modos de transmisión STDIO y SSE (Server-Sent Events)
• 🛠️ Fácil integración: Se puede integrar como herramienta MCP en aplicaciones de IA

📦 Instalación

Instalación global

npm install -g @acwink/movies-search-mcp

Usar npx (recomendado)

# 默认 STDIO 模式
npx @acwink/movies-search-mcp

# SSE 模式
npx @acwink/movies-search-mcp --sse

🚀 Uso

Uso desde línea de comandos

# 默认 STDIO 模式 (适合 MCP 客户端)
movies-search-mcp

# SSE 模式 (适合 Web 应用)
movies-search-mcp --sse

# 指定端口 (仅 SSE 模式)
PORT=3001 movies-search-mcp --sse

Integración con cliente MCP

Agrega esta herramienta a la configuración de tu cliente MCP:

{
  "mcpServers": {
    "movies-search-mcp": {
      "command": "npx",
      "args": ["@acwink/movies-search-mcp"]
    }
  }
}

Herramientas disponibles

1. search_movie

Busca recursos de películas o series

// 搜索电影
{
  "title": "阿凡达",
  "type": "movie"
}

// 搜索电视剧
{
  "title": "权力的游戏",
  "type": "tv",
  "season": 1,
  "episode": 1
}

2. validate_video_url

Verifica la reproducibilidad de los enlaces de video

// 单个链接验证
{
  "url": "https://example.com/video/123"
}

// 批量验证
{
  "url": [
    "https://example.com/video/123",
    "https://example.com/video/456"
  ]
}

🔧 Desarrollo

Desarrollo local

# 克隆项目
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

Estructura del proyecto

src/
├── cli.ts              # CLI 入口文件
├── mcp-server.ts       # STDIO MCP 服务器
├── mcp-server-sse.ts   # SSE MCP 服务器
├── sources/            # 视频源实现
├── core/              # 验证器实现
├── types/             # 类型定义
└── utils/             # 工具函数

🌐 Puntos finales de API (modo SSE)

Cuando se usa el modo SSE, el servidor inicia los siguientes puntos finales:

• GET /sse - Establecer conexión SSE
• POST /messages - Enviar mensajes JSON-RPC
• GET /health - Verificación de salud

📄 Licencia

MIT License

🤝 Contribuciones

¡Bienvenidos a enviar Issues y Pull Requests!

📞 Soporte

Si encuentras algún problema, por favor:

1. Consulta Issues
2. Crea un nuevo Issue
3. Contacta al autor: seanwangjs@example.com

---

⭐ Si este proyecto te ha sido útil, ¡dale una estrella!