Aistudio MCP Server

🚀 AI Studio MCP Server

Google AI Studio / Gemini API と統合されたモデルコンテキストプロトコル (MCP) サーバーです。ファイル、会話履歴、システムプロンプトをサポートしたコンテンツ生成機能を提供します。

🚀 クイックスタート

このサーバーを使用することで、Gemini APIを利用して様々な形式のコンテンツ生成を行うことができます。以下の手順に従ってセットアップしてください。

✨ 主な機能

• Google AI Studio / Gemini API との統合によるコンテンツ生成
• ファイル、会話履歴、システムプロンプトのサポート
• 様々なファイル形式（画像、PDF、オフィスドキュメント、テキストファイルなど）のサポート

📦 インストール

前提条件

• 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分
export GEMINI_MAX_OUTPUT_TOKENS=16384  # より多くの出力トークン
export GEMINI_MAX_FILES=5  # リクエストごとに5つのファイルに制限
export GEMINI_MAX_TOTAL_FILE_SIZE=100  # 100MB制限
export GEMINI_TEMPERATURE=0.7  # より創造的な応答

💻 使用例

基本的な使用法

{
  "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"}
  ]
}

📚 ドキュメント

利用可能なツール

generate_content

Geminiを使用してコンテンツを生成します。ファイル、会話履歴、システムプロンプトを総合的にサポートします。画像、PDF、オフィスドキュメント、テキストファイルなどの様々なファイル形式をサポートします。

パラメータ:

• 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（ファイルごとに最大15MB）
• ドキュメント: PDF（画像として扱われ、1ページ = 1画像）
• テキスト: TXT、MD、JSON、XML、CSV、HTML

ファイル制限:

• 最大ファイルサイズ: 音声/動画/ドキュメントファイルごとに15MB
• リクエストの合計最大サイズ: 20MB（クラウドストレージを使用する場合は2GB）
• 動画ファイル: リクエストごとに最大10ファイル
• PDFファイルは画像の料金体系に従います（1ページ = 1画像）

一般的なユースケース

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