Artin0123-gemini-image-mcp-server

image-mcp-server-gemini

これはリモートサーバーです。ローカルの画像や動画を扱う場合は、ローカル版を使用してください。

機能

• 1 回のツール呼び出しで、1 つ以上の画像 URL を分析します。
• ファイルをローカルにダウンロードせずに、YouTube 動画を分析します。
• 環境変数で API キーを指定し、必要に応じて Gemini モデルを変更できます。
• ファイルサイズの上限：高速な処理を実現するため、画像のサイズは 16 MB までです。
• YouTube 動画：Gemini API に直接ストリーミングするため、サイズの上限はありません。

インストール

Smithery 経由でのインストール

Claude Desktop にサーバーをインストールします。

npx -y @smithery/cli install @Artin0123/gemini-image-mcp-server --client claude

手動インストール

# Clone the repository
git clone https://github.com/Artin0123/gemini-vision-mcp.git
cd gemini-vision-mcp

# Install dependencies
npm install

# Compile TypeScript to dist/
npm run build

設定

Google AI Studioで Gemini API キーを作成し、GEMINI_API_KEYをサーバーに設定してください。

{
  "mcpServers": {
    "gemini-media": {
      "command": "node",
      "args": ["/absolute/path/to/gemini-vision-mcp/dist/index.js"],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here",
        "GEMINI_MODEL": "models/gemini-flash-lite-latest"
      }
    }
  }
}

キーが指定されていない場合でもサーバーは起動できます（自動スキャンに便利です）が、有効な API キーを設定するまでは、ツールを呼び出すと設定エラーが返されます。

モデルの変更

サーバーはデフォルトでmodels/gemini-flash-lite-latestを使用します。次のいずれかの方法で変更できます。

GEMINI_MODEL環境変数を設定するか、Smithery／SDK の設定スキーマでmodelNameを指定します。

使用可能なツール

• analyze_image：1 つ以上の画像 URL を分析します。画像あたりのファイルサイズ上限：16 MB。
• analyze_youtube_video：URL から YouTube 動画を分析します。サイズの上限はありません。

画像 URL はダウンロードされ、高速な応答を実現するため、ファイルサイズの上限 16 MB が適用されます。この上限を超えたファイルには、実際のファイルサイズを示すエラーメッセージが表示されます。

YouTube 動画はダウンロードされず、Gemini API に直接ストリーミングされるため、サイズの制限はありません。

プロンプトの例

Please analyze this product photo: https://teimg-bgr.pages.dev/file/mvYT6KeF.webp

Extract the main talking points from this clip: https://www.youtube.com/watch?v=dQw4w9WgXcQ

開発

npm install
npm test
npm run build

テストスイートでは、URL の転送、MIME の処理、設定のフォールバックをテストします。

ライセンス

MIT