drakonkat/wizzy-mcp-tmdb

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

4 stars 5 forks 品質 61 トレンド 12MIT

The wizzy-mcp-tmdb project is an MCP (Model Context Protocol) server implemented in JavaScript that provides tools to search and retrieve information from The Movie Database (TMDB).

概要

The wizzy-mcp-tmdb project is an MCP (Model Context Protocol) server implemented in JavaScript that provides tools to search and retrieve information from The Movie Database (TMDB). It allows AI clients to access movie, TV show, and person data through a standardized protocol. - : Perform multi-search across movies, TV shows, and people using the search_tmdb tool. - : Fetch detailed information for specific items using the get_tmdb_details tool. - : Retrieve trending content across all media types with the trending_all tool. - Node.js version 18 or higher (required for global fetch support) - A TMDB API key (Bearer token) from your admin, used with the TNL TMDB proxy (production-api.tnl.one) 1. Clone the repository and navigate to the project directory. 3. Set up your TMDB API key as an environment variable: The server communicates over stdio and should be configured in your MCP-compatible client (e.g., IDE or chat client) with the command node mcp-tmdb-server.

README

以下は原文 README の抜粋です。原文を見る。

wizzy-mcp-tmdb

Project Overview and Purpose

Key Features

Search Movies: Perform multi-search across movies, TV shows, and people using the search_tmdb tool.
Get Details: Fetch detailed information for specific items using the get_tmdb_details tool.
Trending Content: Retrieve trending content across all media types with the trending_all tool.

Installation

Prerequisites

Node.js version 18 or higher (required for global fetch support)
A TMDB API key (Bearer token) from your admin, used with the TNL TMDB proxy (production-api.tnl.one)

Setup

Clone the repository and navigate to the project directory.
Install dependencies:
```
npm install
```

Set up your TMDB API key as an environment variable:

On Windows PowerShell:

$env:TMDB_AUTH_TOKEN="YOUR_TNL_PROXY_BEARER_TOKEN"

On macOS/Linux:

export TMDB_AUTH_TOKEN="YOUR_TNL_PROXY_BEARER_TOKEN"

Usage

Starting the MCP Server

To start the server:

npm start

The server communicates over stdio and should be configured in your MCP-compatible client (e.g., IDE or chat client) with the command node mcp-tmdb-server.js and the TMDB_AUTH_TOKEN environment variable.

MCP Integration Examples

Here are code snippets showing how to integrate with the MCP tools:

Search for Movies

// Example MCP tool call for searching
{
  "method": "tools/call",
  "params": {
    "name": "search_tmdb",
    "arguments": {
      "query": "dune",
      "page": 1,
      "language": "en-US",
      "include_adult": false
    }
  }
}

Get Movie Details

// Example MCP tool call for getting details
{
  "method": "tools/call",
  "params": {
    "name": "get_tmdb_details",
    "arguments": {
      "type": "movie",
      "id": 438631,
      "append": "credits,images"
    }
  }
}

// Example MCP tool call for trending content
{
  "method": "tools/call",
  "params": {
    "name": "trending_all",
    "arguments": {
      "time_window": "day",
      "page": 1,
      "language": "en-US"
    }
  }
}

MCP Client Integration

Per integrare questo MCP server nel tuo client MCP (come un IDE o un client di chat compatibile), segui questi passi:

Installa il pacchetto npm se necessario:
```
npm install -g wizzy-mcp-tmdb
```

GitHub で README 全文を見る

インストール

npx wizzy-mcp-tmdb

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
     "mcpServers": {
       "tmdb": {
         "command": "npx",
         "args": ["wizzy-mcp-tmdb"],
         "env": {
           "TMDB_AUTH_TOKEN": "YOUR_TNL_PROXY_BEARER_TOKEN"
         },
         "alwaysAllow": [
           "get_watch_providers",
           "discover_tv",
           "discover_by_provider"
         ]
       }
     }
   }