AI导哈

电影数据库查询服务

一个基于Scala 3的MCP服务器，用于查询TMDB（The Movie Database）API，提供电影搜索、详情获取和即将上映电影列表功能。

  • by camillernd
  • Scala
  • 本地部署
  • 更新于
在 GitHub 查看 camillernd/movie-mcp

使用说明

电影mcp

SCALA 3中的MCP（模型上下文协议）服务器，用于查询TMDB API（电影数据库）。展示了3种搜索和获取电影信息的工具。

使用的技术

语言和框架

  • Scala 3.3.7 -函数式编程语言
  • 南非镑1.11.7 -Scala的构建工具

主要图书馆

  • 烟囱0.1.6 -用于创建MCP服务器的模型上下文协议（MCP）框架
  • 磁带1.13.1 -API类型安全端点描述
  • 奈蒂 -用于公开端点的HTTP服务器
  • STTP客户端4.0.13 -用于调用TMDB API的HTTP客户端
  • 大约0.14.15 解析和JSON生成
  • 日志1.5.21 -原木管理
  • Doten java 3.2.0 -从.env文件加载环境变量

可用工具

此MCP服务器公开了与TMDB API交互的3个工具：

  1. 电影搜索工具 -薄膜研究
  2. 电影详细信息工具 -获取特定电影的详细信息
  3. MovieUpcoming工具 -获取即将上映的电影列表

先决条件

  • Java JDK 11或更高版本 （推荐：JDK 17或21）
  • 南非镑1.11.7 安装在您的系统上
  • API TMDB （免费，在 themoviedb.org)

配置

1.创建.env文件

创建文件 .env 在项目根目录中使用TMDB API密钥：

# Configuration pour l'API TMDB (The Movie Database)
TMDB_API_KEY_V3="votre_clé_api_ici"

注： 文件 .env.example 作为模型提供。

2.获取TMDB API密钥

  1. 在上创建帐户 themoviedb.org
  2. 转到您的帐户设置>API
  3. 请求API密钥（v3）
  4. 将密钥复制到文件中 .env

构建

倒编译器程序：

sbt compile

跑

要启动MCP服务器：

sbt run

服务器将启动并公开MCP工具。

建筑

该项目遵循纯功能架构，职责分离：

  • config/ -环境变量的配置和加载
  • model/ -数据模型（案例类）
  • service/ -调用TMDB API的业务服务
  • tool/ -MCP工具的实现
  • server/ -主MCP服务器

使用的API

本项目使用API TMDB v3 （电影数据库）：

相关 MCP