d content.\n * *Required Params:* `cacheName` (string - e.g., `cachedContents/abc123xyz`) ## Usage Examples Here are examples of how an MCP client (like Cline) might call these tools using the `use_mcp_tool` format: **Example 1: Simple Content Generation (Using Default Model)** ```xml gemini-server gemini_generateContent { "prompt": "Write a short poem about a rubber duck." } ``` **Example 2: Content Generation (Specifying Model & Config)** ```xml gemini-server gemini_generateContent { "modelName": "gemini-1.0-pro", "prompt": "Explain the concept of recursion in programming.", "generationConfig": { "temperature": 0.7, "maxOutputTokens": 500 } } ``` **Example 3: Starting and Continuing a Chat** *Start Chat:* ```xml gemini-server gemini_startChat {} ``` *(Assume response contains `sessionId: "some-uuid-123"`)* *Send Message:* ```xml gemini-server gemini_sendMessage { "sessionId": "some-uuid-123", "message": "Hello! Can you tell me about the Gemini API?" } ``` **Example 4: Uploading a File** ```xml gemini-server gemini_uploadFile { "filePath": "C:\\Users\\YourUser\\Documents\\my_document.txt", // IMPORTANT: Use absolute path with escaped backslashes if needed "displayName": "My Document" } ``` ## Error Handling The server aims to return structured errors using the MCP standard `McpError` type when tool execution fails. This object typically contains: * `code`: An `ErrorCode` enum value indicating the type of error (e.g., `InvalidParams`, `InternalError`, `PermissionDenied`, `NotFound`). * `message`: A human-readable description of the error. * `details`: (Optional) An object potentially containing more specific information from the underlying Gemini SDK error (like safety block reasons or API error messages) for troubleshooting. **Common Error Scenarios:** * **Invalid API Key:** Often results in an `InternalError` with details indicating an authentication failure. * **Invalid Parameters:** Results in `InvalidParams` (e.g., missing required field, wrong data type). * **Safety Blocks:** May result in `InternalError` with details indicating `SAFETY` as the block reason or finish reason. * **File/Cache Not Found:** May result in `NotFound` or `InternalError` depending on how the SDK surfaces the error. * **Rate Limits:** May result in `ResourceExhausted` or `InternalError`. Check the `message` and `details` fields of the returned `McpError` for specific clues when troubleshooting. ## Development This server follows the standard MCP server structure outlined in the project's `.clinerules` and internal documentation. Key patterns include: * **Service Layer (`src/services`):** Encapsulates interactions with the `@google/genai` SDK, keeping it decoupled from MCP specifics. * **Tool Layer (`src/tools`):** Adapts service layer functionality to MCP tools, handling parameter mapping and error translation. * **Zod Schemas (`src/tools/*Params.ts`):** Used extensively for defining tool parameters, providing validation, and generating detailed descriptions crucial for LLM interaction. * **Configuration (`src/config`):** Centralized management via `ConfigurationManager`. * **Types (`src/types`):** Clear TypeScript definitions. ## Known Issues * `gemini_generateContentStream` uses a workaround, collecting all chunks before returning the full text. True streaming to the MCP client is not yet implemented. * `gemini_listFiles` and `gemini_listCaches` m

#mcp-gemini

MCP Gemini Server