Movies Search Tool

🎬 Movies Search Tool

Uma ferramenta inteligente de busca de recursos de filmes e séries, construída com base no Model Context Protocol (MCP), com suporte a busca em múltiplas fontes de vídeo e validação de links.

✨ Recursos

• 🔍 Busca multi-fonte: Suporte a busca de recursos em múltiplos sites de vídeo
• ✅ Validação de links: Valida automaticamente a reprodução dos links de vídeo
• 🚀 Protocolo MCP: Totalmente compatível com o Model Context Protocol
• 📡 Suporte a dois modos: Modos de transmissão STDIO e SSE (Server-Sent Events)
• 🛠️ Fácil integração: Pode ser integrado como ferramenta MCP em aplicações de IA

📦 Instalação

Instalação global

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

Usando npx (recomendado)

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

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

🚀 Como usar

Uso via linha de comando

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

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

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

Integração com cliente MCP

Adicione esta ferramenta à configuração do seu cliente MCP:

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

Ferramentas disponíveis

1. search_movie

Busca recursos de filmes ou séries

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

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

2. validate_video_url

Valida a reprodução dos links de vídeo

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

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

🔧 Desenvolvimento

Desenvolvimento 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

Estrutura do projeto

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

🌐 Endpoints da API (modo SSE)

Ao usar o modo SSE, o servidor inicia os seguintes endpoints:

• GET /sse - Estabelece conexão SSE
• POST /messages - Envia mensagens JSON-RPC
• GET /health - Verificação de saúde

📄 Licença

MIT License

🤝 Contribuição

Contribuições são bem-vindas! Envie Issues e Pull Requests!

📞 Suporte

Se você encontrar algum problema:

1. Consulte as Issues
2. Crie uma nova Issue
3. Entre em contato com o autor: seanwangjs@example.com

---

⭐ Se este projeto foi útil para você, dê uma estrela!