Google AI Studio MCP Server

AI Studio MCP Server

Google AI Studio／Gemini API と連携する Model Context Protocol（MCP）サーバーです。ファイル、会話履歴、システムプロンプトに対応したコンテンツ生成機能を提供します。

インストールと使用方法

前提条件

• Node.js 20.0.0 以降
• Google AI Studio API キー

npx を使用する（推奨）

GEMINI_API_KEY=your_api_key npx -y aistudio-mcp-server

ローカルインストール

npm install -g aistudio-mcp-server
GEMINI_API_KEY=your_api_key aistudio-mcp-server

設定

Google AI Studio API キーを環境変数として設定します。

export GEMINI_API_KEY=your_api_key_here

オプション設定

• GEMINI_MODEL：使用する Gemini モデル（デフォルト：gemini-2.5-flash）
• GEMINI_TIMEOUT：リクエストのタイムアウト時間（ミリ秒、デフォルト：300000 = 5 分）
• GEMINI_MAX_OUTPUT_TOKENS：出力トークンの最大数（デフォルト：8192）
• GEMINI_MAX_FILES：リクエストあたりのファイルの最大数（デフォルト：10）
• GEMINI_MAX_TOTAL_FILE_SIZE：ファイルの合計サイズの上限（MB、デフォルト：50）
• GEMINI_TEMPERATURE：生成時の温度（0～2、デフォルト：0.2）

例：

export GEMINI_API_KEY=your_api_key_here
export GEMINI_MODEL=gemini-2.5-flash
export GEMINI_TIMEOUT=600000  # 10 minutes
export GEMINI_MAX_OUTPUT_TOKENS=16384  # More output tokens
export GEMINI_MAX_FILES=5  # Limit to 5 files per request
export GEMINI_MAX_TOTAL_FILE_SIZE=100  # 100MB limit
export GEMINI_TEMPERATURE=0.7  # More creative responses

利用可能なツール

generate_content

Gemini を使用して、ファイル、会話履歴、システムプロンプトに幅広く対応したコンテンツを生成します。画像、PDF、Office ドキュメント、テキストファイルなど、さまざまなファイル形式に対応しています。

パラメーター：

• user_prompt（文字列、必須）：生成に使用するユーザープロンプト
• system_prompt（文字列、任意）：AI の動作を誘導するシステムプロンプト
• files（配列、任意）：生成に含めるファイルの配列
  • 各ファイルオブジェクトには path または content が必要です
  • path（文字列）：ファイルのパス
  • content（文字列）：Base64 でエンコードされたファイルの内容
  • type（文字列、任意）：MIME タイプ（ファイル拡張子から自動検出）
• model（文字列、任意）：使用する Gemini モデル（デフォルト：gemini-2.5-flash）
• temperature（数値、任意）：生成時の温度（0～2、デフォルト：0.2）。値が低いほど焦点の定まった回答になり、値が高いほど創造的な回答になります。

対応ファイル形式（Gemini 2.5 モデル）：

• 画像：JPG、JPEG、PNG、GIF、WebP、SVG、BMP、TIFF
• 動画：MP4、AVI、MOV、WEBM、FLV、MPG、WMV（リクエストあたり最大 10 ファイル）
• 音声：MP3、WAV、AIFF、AAC、OGG、FLAC（1 ファイルあたり最大 15MB）
• ドキュメント：PDF（画像として扱われ、1 ページが 1 枚の画像になります）
• テキスト：TXT、MD、JSON、XML、CSV、HTML

ファイルの制限：

• ファイルサイズの上限：音声／動画／ドキュメントファイル 1 つあたり 15MB
• リクエスト全体のサイズの上限：20MB（Cloud Storage の使用時は 2GB）
• 動画ファイル：リクエストあたり最大 10 ファイル
• PDF ファイルには画像と同じ料金が適用されます（1 ページが 1 枚の画像になります）

基本的な例：

{
  "user_prompt": "Analyze this image and describe what you see",
  "files": [
    {
      "path": "/path/to/image.jpg"
    }
  ]
}

PDF から Markdown への変換：

{
  "user_prompt": "Convert this PDF to well-formatted Markdown, preserving structure and formatting. Return only the Markdown content.",
  "files": [
    {
      "path": "/path/to/document.pdf"
    }
  ]
}

システムプロンプトを使用する場合：

{
  "system_prompt": "You are a helpful document analyst specialized in technical documentation",
  "user_prompt": "Please provide a detailed explanation of the authentication methods shown in this document",
  "files": [
    {"path": "/api-docs.pdf"}
  ]
}

複数ファイルの例：

{
  "user_prompt": "Compare these documents and images",
  "files": [
    {"path": "/document.pdf"},
    {"path": "/chart.png"},
    {"content": "base64encodedcontent", "type": "image/jpeg"}
  ]
}

一般的な使用例

PDF から Markdown への変換

PDF ファイルを Markdown 形式に変換するには、適切なプロンプトを指定して generate_content ツールを使用します。

{
  "user_prompt": "Convert this PDF to well-formatted Markdown, preserving structure, headings, lists, and formatting. Include table of contents if the document has sections.",
  "files": [
    {
      "path": "/path/to/document.pdf"
    }
  ]
}

画像分析

画像、グラフ、図、写真を詳細な説明とともに分析します。

{
  "system_prompt": "You are an expert image analyst. Provide detailed, accurate descriptions of visual content.",
  "user_prompt": "Analyze this image and describe what you see. Include details about objects, people, text, colors, and composition.",
  "files": [
    {
      "path": "/path/to/image.jpg"
    }
  ]
}

スクリーンショットや技術図の場合：

{
  "user_prompt": "Describe this system architecture diagram. Explain the components and their relationships.",
  "files": [
    {
      "path": "/architecture-diagram.png"
    }
  ]
}

音声の文字起こし

音声ファイルから文字起こしを生成します。

{
  "system_prompt": "You are a professional transcription service. Provide accurate, well-formatted transcripts.",
  "user_prompt": "Please transcribe this audio file. Include speaker identification if multiple speakers are present, and format it with proper punctuation and paragraphs.",
  "files": [
    {
      "path": "/meeting-recording.mp3"
    }
  ]
}

インタビューや会議の文字起こしの場合：

{
  "user_prompt": "Transcribe this interview and provide a summary of key points discussed.",
  "files": [
    {
      "path": "/interview.wav"
    }
  ]
}

MCP クライアントの設定

このサーバーを MCP クライアントの設定に追加します。

{
  "mcpServers": {
    "aistudio": {
      "command": "npx",
      "args": ["-y", "aistudio-mcp-server"],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here",
        "GEMINI_MODEL": "gemini-2.5-flash",
        "GEMINI_TIMEOUT": "600000",
        "GEMINI_MAX_OUTPUT_TOKENS": "16384",
        "GEMINI_MAX_FILES": "10",
        "GEMINI_MAX_TOTAL_FILE_SIZE": "50",
        "GEMINI_TEMPERATURE": "0.2"
      }
    }
  }
}

開発

セットアップ

Node.js 20.0.0 以降がインストールされていることを確認してください。

npm install
npm run build

ローカルで実行する

GEMINI_API_KEY=your_api_key npm run dev

ライセンス

MIT