Omdb

@pipeworx/omdb

OMDb MCP — IMDB由来の映画／テレビ番組／エピソードのメタデータです。APIキーはご自身でご用意ください。

Pipeworx の一部です。AI エージェントを1683以上のライブデータソースに接続するMCPゲートウェイです。

ツール

• search_titles(query, year?, type?, page?)
• get_by_title(title, year?, type?, plot?)
• get_by_imdb_id(imdb_id, plot?)

認証

APIキーはご自身でご用意ください。無料枠はキーごとに1日1,000回の検索です。ゲートウェイのURLに ?_apiKey=<key> を付けてください。https://www.omdbapi.com/apikey.aspx で登録できます。

データソース

https://www.omdbapi.com/ — ?apikey= クエリパラメーターを使用します。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "omdb": {
      "url": "https://gateway.pipeworx.io/omdb/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/omdb/mcp の tools/list は、上の表にあるツールに加えて、Pipeworx 共通のメタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック固有のツールに加えて、共通ツールがおよそ30個表示されます。接続の initialize 応答には正確な対象範囲が記載されており、その日の状況を確認するうえでの確かな情報源です。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使えば、このパックが対応していない質問にも、カタログ全体を横断してルーティングする ask_pipeworx を通じて回答できます。MCP サーバーをもう1つ追加する必要はありません。現時点では、メタツールを含めずにパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

また、フル Pipeworx ゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらのURLも、同じゲートウェイと同じ1683以上のデータソースに接続します。異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP で呼び出す

このパックではご自身のAPIキー（_apiKey）を使用します。こちらではキーを用意していないため、キーなしで実行できる curl コマンドはありません。任意のツールを調べるには、GET https://gateway.pipeworx.io/v1/tools/search_titles を使用してください。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使用してください。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへの往復通信も不要です。

{
  "mcpServers": {
    "omdb": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-omdb"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-omdb

stdin/stdout 経由で MCP を使用し、このパック固有のツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共通メタツールは含まれません。同じデータソース、同じツールを利用できますが、ask_pipeworx によるルーティングはありません。

ask_pipeworx での利用

ツールを直接呼び出す代わりに、自然な英語で質問することもできます。上記のパックエンドポイントでも、フルゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Omdb data" })

ゲートウェイが適切なツールを選択し、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT