电影数据库查询服务

一个基于FastMCP的服务,提供对MongoDB电影数据库的自然语言查询功能,支持按标题、类型、演员、年份或评分搜索电影。

  • by patw
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 patw/movie-mcp-simple

使用说明

电影数据库MCP服务器(简化版)

一个FastMCP服务器,通过自然语言查询提供对MongoDB电影数据库的访问。

特性

  • 按标题、流派、演员、年份或评级搜索电影
  • 按年份或类型获得最高评价的电影
  • 统计符合条件的电影数量
  • 获取特定电影的详细信息

先决条件

  • Python 3.7+
  • MongoDB(本地或云端)
  • sample_mflix 数据库与 movies 收集

安装

  1. 克隆此存储库:
git clone https://github.com/patw/movie-mcp-simple.git
cd movie-mcp-simple
  1. 安装依赖项:
pip install pymongo fastmcp python-dotenv
  1. 创建一个 .env 带有MongoDB连接字符串的文件:
cp sample.env .env

编辑 .env 文件以添加您的实际MongoDB URI。

用法

使用以下配置在Claude桌面中配置MCP服务器:

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

您可以问的示例查询:

  • “寻找与汤姆·汉克斯合作的电影”
  • “喜剧电影有多少部?”
  • “1994年的五大电影是什么?”
  • “给我看《肖申克的救赎》的细节”

MCP工具

服务器提供以下工具:

find_movies

使用各种滤镜搜索电影:

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

count_movies

计数符合条件的电影:

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

get_top_movies

获得评价最高的电影:

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

get_movie_details

获取特定电影的完整详细信息:

get_movie_details(title)

许可证

麻省理工学院