mcp-imdb MCP server

mcp-imdb MCP サーバー

IMDB データにアクセスするための Model Context Protocol（MCP）サーバーです。 原作者：Cheng-Lung Sung

コンポーネント

リソース

このサーバーは、シンプルなメモ保存システムを実装しています。

• 個々のメモにアクセスするためのカスタム note:// URI スキーム
• 各メモリソースには、名前、説明、text/plain MIME タイプがあります

プロンプト

このサーバーは、単一のプロンプトを提供します。

• summarize-notes：保存されているすべてのメモの要約を作成します
  • 詳細レベル（brief/detailed）を指定する省略可能な「style」引数
  • 現在のすべてのメモとスタイル設定を組み合わせたプロンプトを生成します

ツール

このサーバーは、1 つのツールを実装しています。

• add-note：サーバーに新しいメモを追加します
  • 必須の文字列引数として「name」と「content」を受け取ります
  • サーバーの状態を更新し、リソースの変更をクライアントに通知します

設定

[TODO: 実装に固有の設定詳細を追加してください]

クイックスタート

インストール

Claude Desktop

MacOS の場合：~/Library/Application\ Support/Claude/claude_desktop_config.json Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

開発用／未公開サーバーの設定

``` "mcpServers": { "mcp-imdb": { "command": "uv", "args": [ "--directory", "/git/mcp-imdb", "run", "mcp-imdb" ] } } ```

公開済みサーバーの設定

``` "mcpServers": { "mcp-imdb": { "command": "uvx", "args": [ "mcp-imdb" ] } } ```

Docker

Docker を使用して、サーバーを HTTP SSE（Server-Sent Events）サーバーとして実行できます。

Docker イメージのビルド

docker build -t mcp-imdb .

Docker イメージの実行

docker run -p 8000:8000 mcp-imdb

SSE 接続用の http://localhost:8000/sse と、POST メッセージ用の http://localhost:8000/messages/ でサーバーを利用できます。

Docker Compose

Docker Compose を使ってサーバーを実行することもできます。docker-compose.yml ファイルを作成します。

services:
  mcp-imdb:
    image: ghcr.io/juanmandev/mcp-imdb:latest
    build: .
    ports:
      - "8000:8000"
    restart: always

次に、以下を実行します。

docker-compose up -d

VS Code GitHub Copilot を Docker に接続する

Docker 経由でサーバーを起動したら、以下を VS Code の settings.json に追加します。

{
  "github.copilot.chat.mcpServers": {
    "mcp-imdb": {
      "type": "sse",
      "url": "http://localhost:8000/sse"
    }
  }
}

開発

ビルドと公開

パッケージを配布できるよう準備するには、以下を実行します。

1. 依存関係を同期し、ロックファイルを更新します。

uv sync

2. パッケージの配布物をビルドします。

uv build

これにより、ソース配布物と wheel 配布物が dist/ ディレクトリに作成されます。

3. PyPI に公開します。

uv publish

注：環境変数またはコマンドフラグで PyPI の認証情報を設定する必要があります。

• トークン：--token または UV_PUBLISH_TOKEN
• またはユーザー名／パスワード：--username／UV_PUBLISH_USERNAME および --password／UV_PUBLISH_PASSWORD

デバッグ

MCP サーバーは stdio 経由で実行されるため、デバッグは難しい場合があります。最適なデバッグ体験を得るために、MCP Inspector の使用を強くおすすめします。

次のコマンドを使って、npm 経由で MCP Inspector を起動できます。

npx @modelcontextprotocol/inspector uv --directory <dir_to>/git/mcp-imdb run mcp-imdb

起動すると、Inspector に URL が表示されます。その URL にブラウザーからアクセスして、デバッグを開始できます。