Advanced Gemini MCP Server

Um servidor MCP de código aberto que se integra com a IA Gemini do Google. Requer uma chave de API do Google Gemini.

Documentação

🇰🇷 Advanced Gemini MCP Server v4.0 - Edição Coreana de Código Aberto

"Esperamos que isso ajude a comunidade global de desenvolvedores!"
"Esperamos que isso ajude a comunidade global de desenvolvedores!"

Inglês

Visão Geral

O Advanced Gemini MCP Server v4.0 é uma implementação abrangente de servidor Model Context Protocol (MCP) que fornece integração perfeita com o Gemini AI do Google. Este projeto de código aberto foi desenvolvido com ❤️ na Coreia do Sul para contribuir com a comunidade global de desenvolvedores.

👨‍💻 Autores

삽질싼타 (Sapjil Santa) - Desenvolvedor Principal
이하늬 (Lee Haneui) - Assistente de IA e Co-desenvolvedor
Contato: codenmsanta@gmail.com

Recursos

🚀 10 Capacidades Avançadas de IA

Geração de Texto - Geração básica de texto com parâmetros personalizáveis
Processamento Multimodal - Suporte para imagens, vídeos e arquivos de áudio
Contagem de Tokens - Contagem precisa de tokens para estimativa de custos
Resposta em Streaming - Streaming em tempo real para respostas longas
Saída JSON Estruturada - Geração de JSON com esquema obrigatório
Instruções do Sistema - Comportamento personalizado da IA com prompts de sistema
Chamada de Funções - Capacidades de execução dinâmica de funções
Execução de Código - Execução segura de código Python com IA
Upload e Análise de Arquivos - Upload e análise de vários formatos de arquivo
Pesquisa Fundamentada - Integração de pesquisa web em tempo real

🔧 Recursos Técnicos

Pronto para Produção: Tratamento abrangente de erros e registro de logs
Segurança em Primeiro Lugar: Gerenciamento de chave de API por variável de ambiente
Coreano + Inglês: Documentação bilíngue e mensagens de erro
Compatível com MCP: Conformidade total com o Model Context Protocol
Suporte Assíncrono: Arquitetura moderna baseada em asyncio
Segurança de Tipos: Dicas de tipo completas para melhor experiência de desenvolvimento

Instalação

Pré-requisitos

Python 3.8 ou superior
Chave de API do Google Gemini
Gerenciador de pacotes pip

Instalação Rápida

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

# Install dependencies
pip install -r requirements.txt

# Set up environment variables
export GEMINI_API_KEY="your-gemini-api-key-here"

Dependências do Pacote

google-genai>=0.7.0
mcp>=1.0.0
asyncio
aiofiles
typing-extensions

Uso

Configuração Básica

Defina sua chave de API:
```
export GEMINI_API_KEY="your-api-key"
```
Execute o servidor:
```
python advanced_gemini_mcp.py
```
Conecte seu cliente MCP e comece a usar as 10 ferramentas disponíveis!

Configuração do Cliente MCP

Adicione à configuração do seu cliente MCP:

{
  "mcpServers": {
    "advanced-gemini": {
      "command": "python",
      "args": ["/path/to/advanced_gemini_mcp.py"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

Configuração

Variáveis de Ambiente

Variável	Obrigatório	Descrição
`GEMINI_API_KEY`	Sim	Sua chave de API do Google Gemini

Personalização

O servidor suporta várias opções de configuração através dos parâmetros das ferramentas:

Temperature: Controle a criatividade (0.0-1.0)
Max Tokens: Limite o comprimento da resposta
Model Selection: Escolha modelos Gemini específicos
File Types: Suporte para múltiplos formatos de mídia

Exemplos

Geração de Texto

# Tool: gemini_generate
{
  "prompt": "Explain quantum computing in simple terms",
  "temperature": 0.7,
  "max_tokens": 1000
}

Análise de Imagem

# Tool: gemini_multimodal
{
  "prompt": "Describe what you see in this image",
  "image_path": "/path/to/image.jpg"
}

Execução de Código

# Tool: gemini_code_execution
{
  "prompt": "Calculate the fibonacci sequence up to 10 numbers and plot it"
}

Referência da API

Para documentação detalhada da API, consulte API_REFERENCE.md.

Contribuindo

Aceitamos contribuições de desenvolvedores do mundo todo! 🌍

Configuração de Desenvolvimento

Faça um fork do repositório
Crie um branch de recurso
Faça suas alterações
Adicione testes
Envie um pull request

Padrões de Codificação

Siga as diretrizes de estilo PEP 8
Adicione dicas de tipo a todas as funções
Inclua docstrings para APIs públicas
Escreva tratamento de erros abrangente

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

Coreano