Advanced Gemini MCP Server

Un servidor MCP de código abierto que se integra con la inteligencia artificial Gemini de Google. Requiere una clave de API de Google Gemini.

GitHubPrueba este MCPPatrocinado

Documentación

README.md

🇰🇷 Advanced Gemini MCP Server v4.0 - Edición de Código Abierto en Coreano

License: MIT Python 3.8+ MCP Compatible Made in Korea

"¡Esperamos que esto ayude a la comunidad global de desarrolladores!"
"전 세계 개발자 커뮤니티에 도움이 되길 바랍니다!"

📋 Tabla de Contenidos | 목차

Inglés

Descripción General

El Advanced Gemini MCP Server v4.0 es una implementación integral de servidor de Protocolo de Contexto de Modelo (MCP) que proporciona una integración perfecta con la IA Gemini de Google. Este proyecto de código abierto fue desarrollado con ❤️ en Corea del Sur para contribuir a la comunidad global de desarrolladores.

👨‍💻 Autores

  • 삽질싼타 (Sapjil Santa) - Desarrollador Principal
  • 이하늬 (Lee Haneui) - Asistente de IA y Co-Desarrolladora
  • Contacto: codenmsanta@gmail.com

Características

🚀 10 Capacidades Avanzadas de IA

  1. Generación de Texto - Generación básica de texto con parámetros personalizables
  2. Procesamiento Multimodal - Soporte para imágenes, videos y archivos de audio
  3. Conteo de Tokens - Conteo preciso de tokens para estimación de costos
  4. Respuesta en Streaming - Streaming en tiempo real para respuestas largas
  5. Salida JSON Estructurada - Generación JSON con esquema forzado
  6. Instrucciones del Sistema - Comportamiento personalizado de IA con prompts del sistema
  7. Llamada de Funciones - Capacidades dinámicas de ejecución de funciones
  8. Ejecución de Código - Ejecución segura de código Python con IA
  9. Carga y Análisis de Archivos - Carga y análisis de varios formatos de archivo
  10. Búsqueda con Fundamentos - Integración de búsqueda web en tiempo real

🔧 Características Técnicas

  • Listo para Producción: Manejo integral de errores y registro
  • Seguridad Primero: Gestión de clave API mediante variables de entorno
  • Coreano + Inglés: Documentación y mensajes de error bilingües
  • Compatible con MCP: Cumplimiento total del Protocolo de Contexto de Modelo
  • Soporte Asíncrono: Arquitectura moderna basada en asyncio
  • Seguridad de Tipos: Sugerencias de tipo completas para una mejor experiencia de desarrollo

Instalación

Requisitos Previos

  • Python 3.8 o superior
  • Clave API de Google Gemini
  • Gestor de paquetes pip

Instalación 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"

Dependencias del Paquete

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

Uso

Configuración Básica

  1. Establece tu clave API:

    export GEMINI_API_KEY="your-api-key"

  2. Ejecuta el servidor:

    python advanced_gemini_mcp.py

  3. Conecta tu cliente MCP y comienza a usar las 10 herramientas disponibles.

Configuración del Cliente MCP

Agrega a la configuración de tu cliente MCP:

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

Configuración

Variables de Entorno

VariableRequeridaDescripción
GEMINI_API_KEYSíTu clave API de Google Gemini

Personalización

El servidor admite varias opciones de configuración a través de parámetros de herramientas:

  • Temperature: Controla la creatividad (0.0-1.0)
  • Max Tokens: Limita la longitud de la respuesta
  • Model Selection: Elige modelos Gemini específicos
  • File Types: Soporte para múltiples formatos multimedia

Ejemplos

Generación de Texto

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

Análisis de Imágenes

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

Ejecución de Código

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

Referencia de API

Para documentación detallada de la API, consulta API_REFERENCE.md.

Contribuciones

¡Damos la bienvenida a contribuciones de desarrolladores de todo el mundo! 🌍

Configuración de Desarrollo

  1. Haz un fork del repositorio
  2. Crea una rama de características
  3. Realiza tus cambios
  4. Agrega pruebas
  5. Envía una solicitud de extracción

Estándares de Codificación

  • Sigue las pautas de estilo PEP 8
  • Agrega sugerencias de tipo a todas las funciones
  • Incluye docstrings para APIs públicas
  • Escribe manejo integral de errores

Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENSE para más detalles.

한국어

개요

고급 제미나이 MCP 서버 v4.0은 구글의 제미나이 AI와 원활한 통합을 제공하는 포괄적인 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. 이 오픈소스 프로젝트는 전 세계 개발자 커뮤니티에 기여하기 위해 대한민국에서 ❤️를 담아 개발되었습니다.

👨‍💻 제작자

  • 삽질싼타 - 주개발자
  • 이하늬 - AI 어시스턴트 & 공동개발자
  • 연락처: codenmsanta@gmail.com

주요 기능

🚀 10가지 고급 AI 기능

  1. 텍스트 생성 - 맞춤 설정 가능한 기본 텍스트 생성
  2. 멀티모달 처리 - 이미지, 동영상, 오디오 파일 지원
  3. 토큰 계산 - 비용 추정을 위한 정확한 토큰 계산
  4. 스트리밍 응답 - 긴 응답을 위한 실시간 스트리밍
  5. 구조화된 JSON 출력 - 스키마 강제 JSON 생성
  6. 시스템 지시사항 - 시스템 프롬프트로 AI 행동 커스터마이징
  7. 함수 호출 - 동적 함수 실행 기능
  8. 코드 실행 - AI와 함께하는 안전한 파이썬 코드 실행
  9. 파일 업로드 및 분석 - 다양한 파일 형식 업로드 및 분석
  10. 근거 기반 검색 - 실시간 웹 검색 통합

🔧 기술적 특징

  • 프로덕션 준비: 포괄적인 오류 처리 및 로깅
  • 보안 우선: 환경 변수 API 키 관리
  • 한국어 + 영어: 이중 언어 문서화 및 오류 메시지
  • MCP 호환: 모델 컨텍스트 프로토콜 완전 준수
  • 비동기 지원: 최신 asyncio 기반 아키텍처
  • 타입 안전성: 더 나은 개발 경험을 위한 완전한 타입 힌트

설치 방법

필수 조건

  • Python 3.8 이상
  • Google Gemini API 키
  • pip 패키지 매니저

빠른 설치

# 저장소 복제
git clone https://github.com/SapjilSanta/advanced-gemini-mcp.git
cd advanced-gemini-mcp

# 의존성 설치
pip install -r requirements.txt

# 환경 변수 설정
export GEMINI_API_KEY="your-gemini-api-key-here"

패키지 의존성

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

사용법

기본 설정

  1. API 키 설정:

    export GEMINI_API_KEY="your-api-key"

  2. 서버 실행:

    python advanced_gemini_mcp.py

  3. MCP 클라이언트 연결 후 10가지 도구 사용 시작!

MCP 클라이언트 설정

MCP 클라이언트 설정에 추가:

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

설정

환경 변수

변수필수설명
GEMINI_API_KEY예Google Gemini API 키

커스터마이징

서버는 도구 매개변수를 통해 다양한 설정 옵션을 지원합니다:

  • Temperature: 창의성 제어 (0.0-1.0)
  • Max Tokens: 응답 길이 제한
  • Model Selection: 특정 Gemini 모델 선택
  • File Types: 다중 미디어 형식 지원

사용 예제

텍스트 생성

# 도구: gemini_generate
{
  "prompt": "양자 컴퓨팅을 쉬운 말로 설명해주세요",
  "temperature": 0.7,
  "max_tokens": 1000
}

이미지 분석

# 도구: gemini_multimodal
{
  "prompt": "이 이미지에서 보이는 것을 설명해주세요",
  "image_path": "/path/to/image.jpg"
}

코드 실행

# 도구: gemini_code_execution
{
  "prompt": "피보나치 수열을 10개까지 계산하고 그래프로 그려주세요"
}

API 참조

자세한 API 문서는 API_REFERENCE.md를 참조하세요.

기여하기

전 세계 개발자들의 기여를 환영합니다! 🌍

개발 환경 설정

  1. 저장소 포크
  2. 기능 브랜치 생성
  3. 변경사항 작성
  4. 테스트 추가
  5. 풀 리퀘스트 제출

코딩 표준

  • PEP 8 스타일 가이드라인 준수
  • 모든 함수에 타입 힌트 추가
  • 공개 API에 대한 독스트링 포함
  • 포괄적인 오류 처리 작성

라이선스

이 프로젝트는 MIT 라이선스 하에 있습니다 - 자세한 내용은 LICENSE 파일을 참조하세요.

🌟 Historial de Estrellas

Star History Chart

💝 Soporte

Si este proyecto te ayuda, considera: 이 프로젝트가 도움이 되신다면 고려해주세요:

  • ⭐ Dar estrella a este repositorio | 이 저장소에 별점 주기
  • 🐛 Reportar errores | 버그 신고
  • 💡 Sugerir funciones | 기능 제안
  • 🔀 Contribuir código | 코드 기여
  • ☕ Invítanos un café | 커피 한 잔 사주기

🤝 Comunidad

Únete a nuestra creciente comunidad: 성장하는 커뮤니티에 참여하세요:

  • GitHub Discussions: Comparte ideas y obtén ayuda
  • Issues: Reporta errores y solicita funciones
  • Email: codenmsanta@gmail.com para contacto directo

Hecho con ❤️ en Corea del Sur | 대한민국에서 사랑으로 제작 🇰🇷