MCP Gemini Server

🚀 Gemini サーバーツールドキュメント

本ドキュメントでは、Gemini サーバーとのやり取り方法を詳細に説明します。利用可能な各種ツール、パラメータ、エラー処理、開発構造について解説します。

🚀 クイックスタート

このガイドでは、Gemini サーバーとのやり取り方法を学ぶことができます。利用可能なツール、パラメータ、エラー処理、開発構造について詳しく説明します。

✨ 主な機能

• 内容生成、チャット機能、ファイルアップロードなどの様々なツールを提供します。
• MCP 標準の McpError 型を使用して、エラーを構造化して返します。
• 標準的な MCP サーバー構造に従って開発されています。

📦 インストール

ドキュメントにはインストール手順に関する内容が記載されていないため、このセクションは省略します。

💻 使用例

基本的な使用法

内容生成

<use_mcp_tool>
  <server_name>gemini-server</server_name>
  <tool_name>gemini_generateContent</tool_name>
  <arguments>
    {
      "prompt": "Write a short poem about a rubber duck."
    }
  </arguments>
</use_mcp_tool>

高度な使用法

ドキュメントに高度な使用法の具体的なコード例が記載されていないため、このセクションは省略します。

📚 ドキュメント

利用可能なツール

1. 内容生成

gemini_generateContent

• 説明: プロンプトに基づいて内容を生成します。
• パラメータ:
  • prompt (文字列, 必須): 入力するプロンプトです。
  • modelName (文字列, 任意): Gemini モデルを指定します（例: gemini-1.0-pro）。
  • generationConfig (オブジェクト, 任意):
    • temperature (数値, 任意): 出力のランダム性を制御します（範囲 0 から 1）。
    • maxOutputTokens (整数, 任意): 生成する内容の最大長を設定します。

2. チャット機能

gemini_startChat

• 説明: 新しいチャットセッションを開始します。
• パラメータ: なし。

gemini_sendMessage

• 説明: 既存のチャットセッションにメッセージを送信し、応答を取得します。
• パラメータ:
  • sessionId (文字列, 必須): チャットセッションの一意の識別子です。
  • message (文字列, 必須): 送信するメッセージです。

3. ファイルアップロード

gemini_uploadFile

• 説明: ファイルをサーバーにアップロードします。
• パラメータ:
  • filePath (文字列, 必須): ファイルの絶対パスです。
  • displayName (文字列, 任意): ファイルの表示名です。

エラー処理

サーバーは、ツールの実行に失敗した場合、MCP 標準の McpError 型を使用して構造化されたエラーを返します。このオブジェクトには通常、以下の情報が含まれます。

• code: エラーの種類を表す ErrorCode 列挙型の値（例: InvalidParams, InternalError, PermissionDenied, NotFound）。
• message: 人間が読めるエラーの説明。
• details: （任意）トラブルシューティングに役立つ、Gemini SDK のエラーの詳細情報を含むオブジェクト。

一般的なエラーシナリオ

• 無効な API キー: 通常、認証失敗のメッセージを含む InternalError が発生します。
• 無効なパラメータ: InvalidParams が返されます（例: 必須フィールドが欠落している、またはデータ型が誤っている場合）。
• セキュリティによるブロック: InternalError が発生し、詳細情報に SAFETY がブロックまたは完了の原因として示されることがあります。
• ファイル/キャッシュが見つからない: SDK がエラーを表示する方法によって、NotFound または InternalError が発生することがあります。
• レート制限: ResourceExhausted または InternalError が発生することがあります。

トラブルシューティングのために、返された message および details フィールドを確認してください。

開発

このサーバーは、プロジェクトの .clinerules および内部ドキュメントに概説されている標準的な MCP サーバー構造に従っています。主要なパターンは以下の通りです。

• サービス層 (src/services): @google/genai SDK とのやり取りをカプセル化し、MCP 固有の内容から切り離します。
• ツール層 (src/tools): サービス層の機能を MCP ツールに適合させ、パラメータのマッピングとエラーの変換を行います。
• Zod スキーマ (src/tools/*Params.ts): ツールのパラメータを定義し、検証を提供し、LLM とのやり取りに重要な詳細な説明を生成するために広く使用されます。
• 設定 (src/config): ConfigurationManager を使用して集中管理されます。
• 型 (src/types): 明確な TypeScript 定義があります。

🔧 技術詳細

ドキュメントに具体的な技術詳細（50 文字以上）が記載されていないため、このセクションは省略します。

📄 ライセンス

ドキュメントにライセンス情報が記載されていないため、このセクションは省略します。

既知の問題

• gemini_generateContentStream は、すべてのチャンクを収集してから完全なテキストを返す回避策を使用しています。MCP クライアントの真正なストリーミングはまだ実装されていません。
• gemini_listFiles と gemini_listCaches は、SDK の Pager オブジェクトを反復処理する際の制限により、nextPageToken を確実に返せない可能性があります。
• gemini_uploadFile は、サーバー環境では絶対ファイルパスが必要です。
• ファイル処理とキャッシュ API は Vertex AI ではサポートされておらず、Google AI Studio API キーのみで使用できます。