Gemini

Gemini MCP Server is a TypeScript Node.js implementation that exposes an MCP-compliant server which integrates with Google's Gemini Pro model. The server offers MCP tools such as generate_text, enabling clients to send prompts and receive Gemini-generated completions through the MCP protocol. To use it, run the server with Node and point your MCP client (e.g., Claude Desktop) to the dist/gemini_mcp_server.js entrypoint, ensuring the GEMINI_API_KEY environment variable is set with your Google Gemini API key. The server handles requests, forwards them to Gemini Pro, and returns structured MCP responses back to the client. Tools available include generate_text for generating text completions from Gemini Pro.

In Claude Desktop, you connect to this MCP server by configuring a new MCP server entry with the following: a node command, the path to the built server script, and the required GEMINI_API_KEY. Once configured, you can select the gemini MCP server from the list and issue MCP requests such as generate_text to obtain Gemini-powered responses.

Prerequisites:

• Node.js 18 or higher
• npm (comes with Node.js)
• TypeScript (for build step)
• Google Gemini API key
• Claude Desktop (optional, for integration)

1. Install via Smithery (automatic):

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

2. Manual installation: Clone the repository and install dependencies:

git clone https://github.com/GeorgeJeffers/gemini-mcp-server.git
cd gemini-mcp-server
npm install

Build the project:

npm run build

3. Run locally (example):

# Ensure GEMINI_API_KEY is set in your environment
export GEMINI_API_KEY=your_api_key_here
node dist/gemini_mcp_server.js

Note: If you plan to integrate with Claude Desktop, follow the Claude integration steps in the README to add the MCP server in Claude Desktop.

Tips and common issues:

• Ensure Node.js v18+ is installed and available in PATH.
• Obtain and set a valid GEMINI_API_KEY in your environment; without it, requests to Gemini Pro will fail.
• The built entrypoint is dist/gemini_mcp_server.js; ensure you run the built file or adjust the command path accordingly.
• When using Smithery for automatic installation, the CLI handles configuration for Claude Desktop; for other clients, use the manual config example.
• If you encounter connection issues in Claude Desktop, verify the cwd path and that the environment variable GEMINI_API_KEY is correctly provided in the MCP server configuration.
• This server exposes the generate_text tool via MCP as described in the CLI/Docs; you can extend or customize other MCP tools by following the project structure.