Aliargun MCP Server Gemini

🚀 Universal Gemini MCP Server

This is a Model Context Protocol (MCP) server that enables the interaction between Google Gemini AI model and Claude Desktop.

✨ Features

• Fully support the MCP protocol.
• Provide real-time response streaming.
• Ensure secure API key handling.
• Offer configurable model parameters.
• Implemented in TypeScript.

🚀 Quick Start

1. Get a Gemini API Key

   • Visit Google AI Studio.
   • Create a new API key.

2. Configure Claude Desktop

   • Locate your configuration file:

     Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
     Windows: %APPDATA%\Claude\claude_desktop_config.json
     Linux: ~/.config/Claude/claude_desktop_config.json
     

   • Add the Gemini configuration:

     {
       "mcpServers": {
         "gemini": {
           "command": "npx",
           "args": ["-y", "github:aliargun/mcp-server-gemini"],
           "env": {
             "GEMINI_API_KEY": "Your API Key"
           }
         }
       }
     }
     

3. Restart Claude Desktop

📚 Documentation

• Claude Desktop Installation Guide - Detailed installation instructions.
• Examples and Usage - Usage examples and advanced configurations.
• Implementation Details - Technical implementation details.
• Development Guide - A guide for developers.
• Troubleshooting Guide - Solutions to common problems.

💻 Usage Examples

Basic Usage

# Clone the repository
git clone https://github.com/aliargun/mcp-server-gemini.git
cd mcp-server-gemini

# Install dependencies
npm install

# Start the development server
npm run dev

🤝 Contributing

Contributions are welcome! Please refer to our Contributing Guide.

❓ Frequently Asked Questions

1. Connection Issues

   • Check if port 3005 is available.
   • Verify your network connection.
   • Refer to the Troubleshooting Guide.

2. API Key Issues

   • Confirm that your API key is correct.
   • Check the permission settings.
   • Refer to the Installation Guide.

🔒 Security

• Handle API keys only through environment variables.
• Do not store or record any sensitive data.
• Regularly update security patches.

📄 License

MIT