Movie Database

Movie Database MCP Server (Simplificado)

Um servidor FastMCP que fornece acesso a um banco de dados de filmes MongoDB com consultas em linguagem natural.

Recursos

• Pesquisar filmes por título, gênero, ator, ano ou classificação
• Obter filmes mais bem avaliados por ano ou gênero
• Contar filmes que correspondem aos critérios
• Obter informações detalhadas sobre filmes específicos

Pré-requisitos

• Python 3.7+
• MongoDB (local ou nuvem)
• Banco de dados sample_mflix com coleção movies

Instalação

1. Clone este repositório:

git clone https://github.com/patw/movie-mcp-simple.git
cd movie-mcp-simple

2. Instale as dependências:

pip install pymongo fastmcp python-dotenv

3. Crie um arquivo .env com sua string de conexão MongoDB:

cp sample.env .env

Edite o arquivo .env para adicionar sua URI MongoDB real.

Uso

Configure o servidor MCP no Claude desktop com a seguinte configuração:

{
"mcpServers": {
"Movie Database": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "fastmcp, pymongo",
        "fastmcp",
        "run",
        "<path to>/movie-mcp-simple/movie-mcp.py"
      ]
    }
  }
}

Exemplos de consultas que você pode fazer:

• "Encontre filmes com Tom Hanks"
• "Quantos filmes de Comédia existem?"
• "Quais são os 5 melhores filmes de 1994?"
• "Mostre-me detalhes de The Shawshank Redemption"

Ferramentas MCP

O servidor fornece estas ferramentas:

find_movies

Pesquise filmes com vários filtros:

find_movies(title=None, genre=None, actor=None, year=None, min_rating=None, limit=10)

count_movies

Conte filmes que correspondem aos critérios:

count_movies(genre=None, year=None, min_rating=None)

get_top_movies

Obtenha os filmes mais bem avaliados:

get_top_movies(year=None, genre=None, limit=5)

get_movie_details

Obtenha detalhes completos de um filme específico:

get_movie_details(title)

Licença

MIT