moviefinder-mcp

TMDB APIをラップしたMCPサーバーです。MCP対応クライアント（Claude Desktop、Claude Codeなど）から、映画やテレビ番組の検索、詳細情報の取得、トレンドの確認、おすすめの取得、配信状況の確認が可能になります。

ツール

すべてのツールは、生のTMDBペイロードではなく、要約されたJSON（ID、タイトル、年、概要、評価、ポスターURL、およびツール固有のフィールド）を返します。

セットアップ

要件: Node 20以上。

npm install
cp .env.example .env
# edit .env and paste your TMDB v4 read access token
npm run build
npm start    # runs the compiled server over stdio

TMDB APIキーの取得

1. https://www.themoviedb.org/ でTMDBアカウントを作成します。

2. https://www.themoviedb.org/settings/api を開きます。

3. API Read Access Token (v4 auth) をコピーします（v3 APIキーではありません）。

4. .env ファイルに TMDB_API_KEY=... として設定します。

サーバーはこれを Authorization: Bearer <token> として送信します。

Claude Desktopへの登録

claude_desktop_config.json を編集します（macOS: ~/Library/Application Support/Claude/claude_desktop_config.json、Windows: %APPDATA%\Claude\claude_desktop_config.json）。

{
  "mcpServers": {
    "moviefinder": {
      "command": "node",
      "args": ["/absolute/path/to/moviefinder-mcp/dist/index.js"],
      "env": {
        "TMDB_API_KEY": "your_v4_read_access_token_here"
      }
    }
  }
}

Claude Desktopを再起動してください。上記のツールが moviefinder サーバーの下に表示されます。

注意事項

• ジャンルリスト (/genre/movie/list) は一度取得され、discover_movies 用にメモリ内にキャッシュされます。

• 401 / 404 / 429 レスポンスは、アクション可能なメッセージとともに表示されます。

• 入力値はTMDB呼び出しの前に zod で検証されます。