MCP Gemini API 서버

MCP Gemini API 서버

site icon
2025.03.30 2
TypeScript텍스트 생성이미지 분석비디오 분석웹 검색内容生成
MCP Gemini API 서버는 Cursor와 Claude를 위한 Google Gemini API 서버로, 텍스트 생성, 이미지 분석, 비디오 분석 등 Gemini의 다양한 기능을 제공합니다. 주요 기능으로는 텍스트 생성, 이미지 생성 및 분석, YouTube 비디오 분석, 웹 검색 등이 포함됩니다. 이 서버는 개발자들이 Gemini API를 쉽게 활용할 수 있도록 도와주며, 다양한 미디어 형식을 처리할 수 있는 능력을 갖추고 있습니다.
View on GitHub

Overview

基本能力

产品定位

MCP Gemini API 서버는 Google Gemini API를 활용하여 텍스트 및 미디어 콘텐츠를 생성하고 분석하는 서버입니다. 개발자들이 Gemini API의 다양한 기능을 쉽게 통합할 수 있도록 지원합니다.

核心功能

  • 텍스트 생성 (gemini-2.0-flash 모델 사용)
  • 이미지 생성 및 분석
  • YouTube 비디오 분석
  • 웹 검색

适用场景

  • AI 기반 텍스트 생성 애플리케이션
  • 이미지 분석 및 생성 도구
  • 비디오 콘텐츠 분석 시스템
  • 웹 검색 기능이 필요한 애플리케이션

工具列表

  • gem-generate: 텍스트 생성
  • gem-generate-image: 이미지 생성/분석
  • gem-analyze-video: YouTube 비디오 분석
  • gem-search: 웹 검색

常见问题解答

  1. 서버가 시작되지 않는 경우
  2. PM2 로그 확인: npm run logs
  3. PM2 프로세스 상태 확인: npm run status

  4. API 키 오류

  5. config.ts 파일에서 API 키 확인
  6. Gemini API 할당량 및 권한 확인

  7. 메모리 사용량 문제

  8. ecosystem.config.js에서 메모리 제한 설정 확인
  9. PM2 모니터링으로 메모리 사용량 추적

使用教程

使用依赖

  • Node.js 18.0.0 이상
  • npm 또는 yarn
  • Google API 키 (Gemini API 접근용)

安装教程

# 저장소 클론
git clone https://github.com/techkwon/mcp-gemini.git
cd mcp-gemini

# 의존성 설치
npm install

环境设置

  1. config.ts 파일에 Google API 키 설정:
export default {
  googleApiKey: "your_api_key_here",
  // 기타 설정...
};

构建及运行

# TypeScript 빌드
npm run build

# 서버 시작 (PM2 사용)
npm start

# 개발 모드로 실행
npm run dev

调试方式

# 서버 상태 확인
npm run status

# 서버 로그 확인
npm run logs

# 서버 중지
npm run stop

# 서버 재시작
npm run restart

许可证

该项目遵循 MIT 开源许可条款。