Movie MCP (Jason H House)

电影MCP服务器

模型上下文协议（MCP）服务器，通过电影数据库（TMDB）API集成提供电影信息。

特性

• 电影搜索：按标题搜索电影
• 电影详细信息：获取特定电影的详细信息
• 热门电影：检索当前流行的电影
• 正在播放：获取当前在影院上映的电影
• 即将上映的电影：查找即将上映的电影

设置

先决条件

• Java 17或更高版本
• Maven 3.6+
• TMDB API密钥（在https://www.themoviedb.org/settings/api)

安装

1. 克隆存储库：

git clone 
cd MovieMCP

1. 将TMDB API密钥设置为环境变量：

macOS/Linux：

export TMDB_API_KEY="your_real_key_here"

窗户：

$env:TMDB_API_KEY = "your_real_key_here"

或更新 application.yml 使用API密钥提交。

1. 构建并运行应用程序：

mvn spring-boot:run

服务器将在端口8080上启动。

MCP集成

此服务器实现了模型上下文协议，可以与兼容MCP的客户端（如Claude Desktop）一起使用。

可用工具

search_movies

按标题搜索电影。

参数：

• query （字符串，必填）：要搜索的电影标题
• page （整数，可选）：页码（默认值：1）

get_movie-details

获取特定电影的详细信息。

参数：

• movieId （整数，必填）：来自TMDB的电影ID

与Claude Desktop一起使用

1. 构建JAR文件：

mvn clean package -DskipTests

1. 配置Claude桌面 通过将此添加到您的 claude_desktop_config.json 文件：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "movie-server": {
      "command": "java",
      "args": [
        "-jar", 
        "/path/to/your/MovieMCP/target/movie-mcp-server-1.0.0.jar",
        "--mcp"
      ],
      "env": {
        "TMDB_API_KEY": "your-tmdb-api-key-here"
      }
    }
  }
}

1. 重新启动克劳德桌面 完全（退出并重新打开）

1. 测试连接 -你应该在Claude中看到可用的电影工具

直接MCP测试

您可以使用命令行直接测试MCP服务器：

# Test initialization
echo '{"jsonrpc":"2.0","id":"1","method":"initialize","params":{}}' | java -jar target/movie-mcp-server-1.0.0.jar --mcp

# Test listing tools
echo '{"jsonrpc":"2.0","id":"2","method":"tools/list","params":{}}' | java -jar target/movie-mcp-server-1.0.0.jar --mcp

# Test movie search
echo '{"jsonrpc":"2.0","id":"3","method":"tools/call","params":{"name":"search_movies","arguments":{"query":"The Matrix"}}}' | java -jar target/movie-mcp-server-1.0.0.jar --mcp

API终点

• POST /mcp/rpc -MCP JSON-RPC端点
• GET /mcp/health -健康检查端点

配置

配置通过以下方式管理 application.yml:

movie:
  api:
    tmdb:
      base-url: https://api.themoviedb.org/3
      api-key: ${TMDB_API_KEY:your-api-key-here}

发展

运行测试

mvn test

建筑

mvn clean package

许可证

该项目根据MIT许可证获得许可。