Gemini With Web Search

🚀 MCP Gemini Protocol Server (MCP Gemini) Usage Guide

MCP Gemini Protocol Server is a middleware developed based on Node.js, designed to provide Gemini AI services. It offers functions such as text generation, image processing, video analysis, and web search through a standard JSON - RPC protocol interface.

📄 License

MIT License

Copyright (c) 2024 Xingchen Technology Company
This project adheres to the MIT License.

📜 Terms of Use

• It is only for non - commercial use and cannot be used for profit without permission.
• Modified versions must include a modification statement.
• The original link must remain visible.

📋 Version History

v1.0.0 (2024 - 03 - 15)

• Initial version released.
• Provides basic functions: text generation, image processing, and video analysis.

v2.0.0 (2024 - 05 - 20)

• Introduced the Gemini 2.0 model.
• Added web search capabilities.
• Optimized the API interface.

✨ Features

Text Generation

• Supports multi - turn conversations.
• Provides context memory.
• Supports multiple languages.

Image Editing

• Based on the Gemini 2.0 model.
• Supports image generation and editing.
• Offers various visual effects.

Video Analysis

• Parses YouTube network videos.
• Automatically extracts content summaries.
• Identifies and locates key frames.

Web Search

• Retrieves real - time network information.
• Filters results intelligently.
• Supports multi - language search.

📦 Installation

Environment Requirements

• Node.js version 18.0.0 or higher.
• npm or yarn package management tool.
• Public cloud service account (optional).

Installation Steps

# Clone the code repository
git clone https://github.com/techkwon/mcp-gemini.git

# Enter the project directory
cd mcp-gemini

# Install dependencies
npm install

# Configure environment variables
export GOOGLE_API_KEY=your_api_key_here

# Start the service
npm run start

Configuration

API Interface Settings

• Default listening address: localhost
• Listening port: 8000
• CORS whitelist: Configurable, supports multiple domains.

Log Management

• Uses pino for structured log recording.
• In the development environment, the pino - pretty module is supported for more user - friendly log display.

⚠️ Security Precautions

1. API keys must be passed through environment variables.
2. It is recommended to enable HTTPS in the production environment.
3. Do not embed key information directly in the code.
4. It is recommended to set access rate limits.
5. Update security certificates regularly.

🛠️ Troubleshooting

Port Conflict

If port 8000 is occupied:

# Find and terminate related processes
sudo lsof -i :8000

# Or use the pstree command to view specific processes
pstree -p | grep node

Service Stability Maintenance

• It is recommended to use professional tools such as PM2 for process management.
• Regularly check system logs to analyze server running status.
• Promptly handle memory leaks and performance degradation issues.

🛠️ Development Guide

Log System

• Uses pino for structured log recording.
• Supports multiple log output formats, with JSON as the default.

Configuration Management

• Environment variables have higher priority than configuration files.
• Provides a default configuration template, which can be customized according to requirements.

🧑‍💼 Project Maintainers

• Zhang San (Project Leader)
• Li Si (Technical Advisor)

🤝 Contribution Guide

Community contributions are welcome! Please read the contribution specification document first to understand how to participate in code development and submissions.

📄 License

This project follows the MIT open - source license, and all contributions will be managed under the MIT license.