[{"_1":2,"_340":-5,"_341":-5},"loaderData",{"_3":4,"_29":30,"_245":246},"root",{"_5":6,"_14":15},"toasts",[7],{"_8":9,"_10":11,"_12":13},"uid","019a2f36-57f7-74b8-bf8c-cf8a6c196dd1","title","You need to sign in to access this page","type","error","visitor",{"_16":17,"_18":19},"viewportWidth",1280,"visitorSession",{"_20":21,"_23":24,"_25":-5,"_26":27,"_28":-5},"attributes",[22],"bot","id",21617481,"membership","referenceId","019a2dfc-1dad-704d-a3b8-88a103e988d5","userAccount","routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_31":32,"_69":-5,"_70":33,"_34":71,"_163":164,"_243":244},"availableLocales",[33,45,52,57,62],{"_34":35,"_38":42,"_43":44},"mcpServer",{"_36":37,"_38":39,"_40":41},"description","A server that provides access to Google Gemini AI capabilities including text generation, image analysis, YouTube video analysis, and web search functionality through the MCP protocol.","name","MCP Gemini API Server","readme","# MCP Gemini API Server\n\nGoogle Gemini API server for Cursor and Claude. Provides various Gemini features such as text generation, image analysis, video analysis, etc.\n\n## Key Features\n\n* Text generation (using the gemini-2.0-flash model)\n* Image creation and analysis\n* YouTube video analytics\n* Web search\n\n## Get started\n\n### Essential Requirements\n\n* Node.js 18.0.0 or later\n* npm or yarn\n* Google API Key (for accessing Gemini API)\n\n### installation\n\n```bash\n# 저장소 클론\ngit clone https://github.com/techkwon/mcp-gemini.git\ncd mcp-gemini\n\n# 의존성 설치\nnpm install\n```\n\n### Preferences\n\n1. Set your Google API key in `config.ts` file:\n\n```typescript\nexport default {\n googleApiKey: \"your_api_key_here\",\n // 기타 설정...\n};\n```\n\n### Build and Run\n\n```bash\n# TypeScript 빌드\nnpm run build\n\n# 서버 시작 (PM2 사용)\nnpm start\n\n# 개발 모드로 실행\nnpm run dev\n```\n\n### PM2 Server Management\n\nThe server is automatically managed via PM2. You can manage the server with the following commands:\n\n```bash\n# 서버 상태 확인\nnpm run status\n\n# 서버 로그 확인\nnpm run logs\n\n# 서버 중지\nnpm run stop\n\n# 서버 재시작\nnpm run restart\n\n# 시스템 재시작 시 자동 실행 설정\npm2 startup\npm2 save\n```\n\n## Cursor/Claude integration\n\n### MCP Settings\n\nAdd the following settings to your `~/.cursor/mcp.json` file:\n\n```json\n{\n \"github.com/techkwon/mcp-gemini\": {\n \"command\": \"npm\",\n \"args\": [\"start\"],\n \"cwd\": \"<프로젝트_경로>\",\n \"env\": {\n \"NODE_ENV\": \"production\"\n },\n \"disabled\": false,\n \"autoStart\": true,\n \"autoApprove\": [\n \"gem-generate\",\n \"gem-generate-image\",\n \"gem-analyze-video\",\n \"gem-search\"\n ]\n }\n}\n```\n\n### API endpoint\n\n* `/gem-generate` : Generate text\n* `/gem-generate-image` : Image generation/analysis\n* `/gem-analyze-video` : Analyze YouTube videos\n* `/gem-search` : Web search\n\n## Major Updates\n\n### Latest version (2024-03)\n\n* Implementing server automation via PM2\n* Unified to gemini-2.0-flash model\n* Added automatic restart and error recovery features\n* Improve your settings\n\n### Previous version\n\n* Added YouTube video analytics feature\n* Improved image creation/analysis capabilities\n* Add web search functionality\n\n## Troubleshooting\n\n### Common Problems\n\n1. **If the server does not start**\n\n ```bash\n # PM2 로그 확인\n npm run logs\n\n # PM2 프로세스 상태 확인\n npm run status\n ```\n\n2. **API Key Error**\n\n * Make sure your API key is set correctly in `config.ts` file.\n * Check Gemini API Quotas and Permissions\n\n3. **Memory usage issues**\n\n * Check memory limit settings in `ecosystem.config.js`\n * Track memory usage with PM2 monitoring\n\n## Contribute\n\n1. Fork the Project\n2. Create your Feature Branch ( `git checkout -b feature/AmazingFeature` )\n3. Commit your Changes ( `git commit -m 'Add some AmazingFeature'` )\n4. Push to the Branch ( `git push origin feature/AmazingFeature` )\n5. Open a Pull Request\n\n## License\n\nThis project is licensed under the MIT License. See [the LICENSE](LICENSE) file for details.\n\n## contact\n\nProject Manager: techkwon Email: Project Link: \n\n## Key Dependencies\n\n* @google/generative-ai: ^0.1.3 (Gemini API SDK)\n* @fastify/cors: ^8.5.0 (CORS support)\n* fastify: ^4.29.0 (web server framework)\n* googleapis: ^148.0.0 (Google API support)\n* typescript: ^5.0.0\n* zod: ^3.24.2 (data validation)\n* pino: ^8.21.0 (logging)\n\n## Claude Desktop App Integration Guide\n\n### Settings file location\n\nThe settings files for the Claude desktop app are located in the following path:\n\n* Windows: `%APPDATA%/Claude/config.json`\n* macOS: `~/Library/Application Support/Claude/config.json`\n\n### Example JSON settings\n\n```json\n{\n \"apis\": [\n {\n \"name\": \"MCP Gemini\",\n \"url\": \"http://localhost:8000\",\n \"methods\": [\n {\n \"name\": \"텍스트 생성\",\n \"method\": \"gem-generate\",\n \"template\": {\n \"jsonrpc\": \"2.0\",\n \"id\": \"{uuid}\",\n \"method\": \"gem-generate\",\n \"params\": {\n \"prompt\": \"{input}\"\n }\n }\n },\n {\n \"name\": \"이미지 생성\",\n \"method\": \"gem-generate-image\",\n \"template\": {\n \"jsonrpc\": \"2.0\",\n \"id\": \"{uuid}\",\n \"method\": \"gem-generate-image\",\n \"params\": {\n \"prompt\": \"{input}\"\n }\n }\n },\n {\n \"name\": \"비디오 분석\",\n \"method\": \"gem-analyze-video\",\n \"template\": {\n \"jsonrpc\": \"2.0\",\n \"id\": \"{uuid}\",\n \"method\": \"gem-analyze-video\",\n \"params\": {\n \"videoUrl\": \"{input}\",\n \"query\": \"이 영상의 주요 내용을 요약해주세요\"\n }\n }\n },\n {\n \"name\": \"웹 검색\",\n \"method\": \"gem-search\",\n \"template\": {\n \"jsonrpc\": \"2.0\",\n \"id\": \"{uuid}\",\n \"method\": \"gem-search\",\n \"params\": {\n \"query\": \"{input}\"\n }\n }\n }\n ]\n }\n ]\n}\n```\n\n### Variable Description\n\n* `{uuid}` : Unique request ID that is automatically generated.\n* `{input}` : Text entered into Claude's chat window\n\n### How to use\n\n1. Open the settings file of the Claude desktop app.\n2. Add the JSON settings above to your existing settings.\n3. Restart the Claude desktop app.\n4. You can use it in the chat window like this:\n\n```\n@MCP Gemini.텍스트 생성 한국의 전통 음식에 대해 설명해주세요\n@MCP Gemini.이미지 생성 한옥마을의 아름다운 풍경\n@MCP Gemini.비디오 분석 https://youtube.com/watch?v=VIDEO_ID\n@MCP Gemini.웹 검색 최신 인공지능 기술 동향\n```\n\n### Response Format\n\nAll API responses follow this format:\n\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"id\": \"요청에서 보낸 ID\",\n \"result\": {\n \"content\": \"응답 내용\"\n }\n}\n```\n\n### Error response\n\nIf an error occurs, respond in the following format:\n\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"id\": \"요청에서 보낸 ID\",\n \"error\": {\n \"code\": 오류코드,\n \"message\": \"오류 메시지\",\n \"data\": {\n \"details\": \"상세 오류 정보\"\n }\n }\n}\n```\n\n## Error Handling\n\nThe server returns an appropriate error response in the following situations:\n\n* 400: Bad request format\n* 401: Authentication error (API key related)\n* 500: Internal server error\n\n## Security Considerations\n\n* Be sure to manage your API key as an environment variable.\n* In a production environment, add appropriate security settings.\n* Be careful not to log sensitive information.\n\n## Troubleshooting\n\n### Port conflict\n\nIf port 8000 is already in use:\n\n```bash\n# 기존 Node.js 프로세스 종료\npkill -f \"node\"\n```\n\n### Server Stability\n\nIf the server terminates unexpectedly:\n\n* Consider using PM2 or another process manager.\n* Check the logs to determine the cause of the termination.\n\n## Development Guide\n\n### Logging\n\n* Implemented structured logging using Pino logger\n* In the development environment, readable logs are output via pino-pretty.\n\n### Type safety\n\n* Ensure runtime type safety using TypeScript and Zod\n* Schema validation for API requests/responses is implemented.\n\n## CLINE MCP Marketplace Registration Guide\n\n### Preliminary Preparation\n\n1. Your GitHub repository must be public\n2. The README.md file should contain clear installation and setup instructions.\n3. (Optional) You can provide additional installation instructions for your AI agent via `llms-install.md` file.\n\n### Registration Procedure\n\n1. Create a new issue in [the CLINE MCP Marketplace repository](https://github.com/cline/mcp-marketplace)\n\n2. The issue includes the following information:\n\n * **GitHub repository URL:** \n * **Logo image:** PNG file in size 400×400\n * **Additional Reason:** Example of the value this MCP server can provide to CLINE users: GXP12\n\n3. Tests whether CLINE can successfully install a server with only README.md\n\n### Approval process\n\n1. The CLINE team reviews submitted MCP servers\n2. We are conducting security and stability verification\n3. Once approved, you will be listed on the Marketplace and accessible to all CLINE users.\n\n### Optimized installation guide\n\nYou can provide additional installation instructions for your AI agent by creating an `llms-install.md` file:\n\n```markdown\n# MCP Gemini 서버 설치 가이드 (AI 에이전트용)\n\n## 환경 요구사항\n- Node.js 18.0.0 이상\n- npm 또는 yarn\n- Google AI Studio API 키\n\n## 설치 단계\n1. 저장소 클론\n2. 의존성 설치: `npm install`\n3. 환경 변수 설정: GOOGLE_API_KEY 추가\n4. 빌드: `npm run build`\n5. 서버 실행: `npm run start`\n\n## 설정 검증\n- 8000번 포트 사용 가능 여부 확인\n- API 키 유효성 검증\n- CORS 설정 확인\n\n## 문제 해결\n- 포트 충돌 시 해결 방법\n- API 키 오류 해결 방법\n- 일반적인 설치 문제 해결 가이드\n```","English","tag","en-US",{"_34":46,"_38":50,"_43":51},{"_36":47,"_38":48,"_40":49},"Un servidor que proporciona acceso a las capacidades de inteligencia artificial de Google Gemini, incluida la generación de texto, el análisis de imágenes, el análisis de videos de YouTube y la funcionalidad de búsqueda web a través del protocolo MCP.","Servidor API MCP Gemini","# Servidor API MCP Gemini\n\nServidor API de Google Gemini para Cursor y Claude. Gemini ofrece una variedad de funciones que incluyen generación de texto, análisis de imágenes y análisis de video.\n\n## Características principales\n\n* Generación de texto (utilizando el modelo gemini-2.0-flash)\n* Creación y análisis de imágenes\n* Análisis de vídeos de YouTube\n* Búsqueda web\n\n## Empezar\n\n### Requisitos esenciales\n\n* Node.js 18.0.0 o posterior\n* npm o hilo\n* Clave API de Google (para acceder a la API de Gemini)\n\n### instalación\n\n```bash\n# 저장소 클론\ngit clone https://github.com/techkwon/mcp-gemini.git\ncd mcp-gemini\n\n# 의존성 설치\nnpm install\n```\n\n### Preferencias\n\n1. Establezca su clave API de Google en `config.ts` :\n\n```typescript\nexport default {\n googleApiKey: \"your_api_key_here\",\n // 기타 설정...\n};\n```\n\n### Construir y ejecutar\n\n```bash\n# TypeScript 빌드\nnpm run build\n\n# 서버 시작 (PM2 사용)\nnpm start\n\n# 개발 모드로 실행\nnpm run dev\n```\n\n### Administración del servidor PM2\n\nEl servidor se gestiona automáticamente a través de PM2. Puede administrar su servidor con los siguientes comandos:\n\n```bash\n# 서버 상태 확인\nnpm run status\n\n# 서버 로그 확인\nnpm run logs\n\n# 서버 중지\nnpm run stop\n\n# 서버 재시작\nnpm run restart\n\n# 시스템 재시작 시 자동 실행 설정\npm2 startup\npm2 save\n```\n\n## Integración de Cursor/Claude\n\n### Configuración de MCP\n\nAgregue las siguientes configuraciones a su archivo `~/.cursor/mcp.json` :\n\n```json\n{\n \"github.com/techkwon/mcp-gemini\": {\n \"command\": \"npm\",\n \"args\": [\"start\"],\n \"cwd\": \"<프로젝트_경로>\",\n \"env\": {\n \"NODE_ENV\": \"production\"\n },\n \"disabled\": false,\n \"autoStart\": true,\n \"autoApprove\": [\n \"gem-generate\",\n \"gem-generate-image\",\n \"gem-analyze-video\",\n \"gem-search\"\n ]\n }\n}\n```\n\n### Punto final de API\n\n* `/gem-generate` : Generar texto\n* `/gem-generate-image` : Generación/análisis de imágenes\n* `/gem-analyze-video` : Analiza vídeos de YouTube\n* `/gem-search` : Búsqueda web\n\n## Actualizaciones importantes\n\n### Última versión (2024-03)\n\n* Implementación de la automatización del servidor a través de PM2\n* Unificado al modelo gemini-2.0-flash\n* Se agregaron funciones de reinicio automático y recuperación de errores.\n* Mejora tu configuración\n\n### Versión anterior\n\n* Se agregó la función de análisis de videos de YouTube\n* Capacidades mejoradas de creación y análisis de imágenes\n* Añadir funcionalidad de búsqueda web\n\n## Solución de problemas\n\n### Problemas comunes\n\n1. **Si el servidor no se inicia**\n\n ```bash\n # PM2 로그 확인\n npm run logs\n\n # PM2 프로세스 상태 확인\n npm run status\n ```\n\n2. **Error de clave API**\n\n * Asegúrese de que su clave API esté configurada correctamente en `config.ts` .\n * Comprobar las cuotas y permisos de la API de Gemini\n\n3. **Problemas de uso de memoria**\n\n * Verifique la configuración del límite de memoria en `ecosystem.config.js`\n * Realice un seguimiento del uso de la memoria con la monitorización de PM2\n\n## Contribuir\n\n1. Bifurcar el proyecto\n2. Crea tu rama de funciones ( `git checkout -b feature/AmazingFeature` )\n3. Confirme sus cambios ( `git commit -m 'Add some AmazingFeature'` )\n4. Empujar a la rama ( `git push origin feature/AmazingFeature` )\n5. Abrir una solicitud de extracción\n\n## Licencia\n\nEste proyecto sigue la licencia MIT. Consulte [el archivo de LICENCIA](LICENSE) para obtener más detalles.\n\n## contacto\n\nGerente de proyecto: techkwon Correo electrónico: Enlace del proyecto: \n\n## Dependencias clave\n\n* @google/generative-ai: ^0.1.3 (SDK de API de Gemini)\n* @fastify/cors: ^8.5.0 (soporte CORS)\n* fastify: ^4.29.0 (marco de servidor web)\n* googleapis: ^148.0.0 (compatibilidad con la API de Google)\n* mecanografiado: ^5.0.0\n* zod: ^3.24.2 (validación de datos)\n* pino: ^8.21.0 (registro)\n\n## Guía de integración de la aplicación de escritorio de Claude\n\n### Ubicación del archivo de configuración\n\nLos archivos de configuración de la aplicación de escritorio Claude se encuentran en la siguiente ruta:\n\n* Ventanas: `%APPDATA%/Claude/config.json`\n* macOS: `~/Library/Application Support/Claude/config.json`\n\n### Ejemplo de configuración JSON\n\n```json\n{\n \"apis\": [\n {\n \"name\": \"MCP Gemini\",\n \"url\": \"http://localhost:8000\",\n \"methods\": [\n {\n \"name\": \"텍스트 생성\",\n \"method\": \"gem-generate\",\n \"template\": {\n \"jsonrpc\": \"2.0\",\n \"id\": \"{uuid}\",\n \"method\": \"gem-generate\",\n \"params\": {\n \"prompt\": \"{input}\"\n }\n }\n },\n {\n \"name\": \"이미지 생성\",\n \"method\": \"gem-generate-image\",\n \"template\": {\n \"jsonrpc\": \"2.0\",\n \"id\": \"{uuid}\",\n \"method\": \"gem-generate-image\",\n \"params\": {\n \"prompt\": \"{input}\"\n }\n }\n },\n {\n \"name\": \"비디오 분석\",\n \"method\": \"gem-analyze-video\",\n \"template\": {\n \"jsonrpc\": \"2.0\",\n \"id\": \"{uuid}\",\n \"method\": \"gem-analyze-video\",\n \"params\": {\n \"videoUrl\": \"{input}\",\n \"query\": \"이 영상의 주요 내용을 요약해주세요\"\n }\n }\n },\n {\n \"name\": \"웹 검색\",\n \"method\": \"gem-search\",\n \"template\": {\n \"jsonrpc\": \"2.0\",\n \"id\": \"{uuid}\",\n \"method\": \"gem-search\",\n \"params\": {\n \"query\": \"{input}\"\n }\n }\n }\n ]\n }\n ]\n}\n```\n\n### Descripción de la variable\n\n* `{uuid}` : ID de solicitud único que se genera automáticamente.\n* `{input}` : Texto ingresado en la ventana de chat de Claude\n\n### Cómo utilizar\n\n1. Abra el archivo de configuración de la aplicación de escritorio Claude.\n2. Agregue la configuración JSON anterior a su configuración existente.\n3. Reinicie la aplicación de escritorio Claude.\n4. Puedes usarlo en la ventana de chat de la siguiente manera:\n\n```\n@MCP Gemini.텍스트 생성 한국의 전통 음식에 대해 설명해주세요\n@MCP Gemini.이미지 생성 한옥마을의 아름다운 풍경\n@MCP Gemini.비디오 분석 https://youtube.com/watch?v=VIDEO_ID\n@MCP Gemini.웹 검색 최신 인공지능 기술 동향\n```\n\n### Formato de respuesta\n\nTodas las respuestas de la API siguen este formato:\n\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"id\": \"요청에서 보낸 ID\",\n \"result\": {\n \"content\": \"응답 내용\"\n }\n}\n```\n\n### Respuesta de error\n\nSi ocurre un error, responda en el siguiente formato:\n\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"id\": \"요청에서 보낸 ID\",\n \"error\": {\n \"code\": 오류코드,\n \"message\": \"오류 메시지\",\n \"data\": {\n \"details\": \"상세 오류 정보\"\n }\n }\n}\n```\n\n## Manejo de errores\n\nEl servidor devuelve una respuesta de error apropiada en las siguientes situaciones:\n\n* 400: Formato de solicitud incorrecto\n* 401: Error de autenticación (relacionado con la clave API)\n* 500: Error interno del servidor\n\n## Consideraciones de seguridad\n\n* Asegúrese de administrar su clave API como una variable de entorno.\n* En un entorno de producción, agregue la configuración de seguridad adecuada.\n* Tenga cuidado de no registrar información confidencial.\n\n## Solución de problemas\n\n### Conflicto portuario\n\nSi el puerto 8000 ya está en uso:\n\n```bash\n# 기존 Node.js 프로세스 종료\npkill -f \"node\"\n```\n\n### Estabilidad del servidor\n\nSi el servidor finaliza inesperadamente:\n\n* Considere utilizar PM2 u otro gestor de procesos.\n* Verifique los registros para determinar la causa de la terminación.\n\n## Guía de desarrollo\n\n### Explotación florestal\n\n* Se implementó el registro estructurado utilizando el registrador Pino\n* En el entorno de desarrollo, los registros legibles se generan a través de pino-pretty.\n\n### Seguridad de tipos\n\n* Garantice la seguridad de tipos en tiempo de ejecución utilizando TypeScript y Zod\n* Se implementa la validación de esquema para solicitudes/respuestas de API.\n\n## Guía de registro del mercado de CLINE MCP\n\n### Preparación preliminar\n\n1. Su repositorio de GitHub debe ser público\n2. El archivo README.md debe contener instrucciones claras de instalación y configuración.\n3. (Opcional) Puede proporcionar instrucciones de instalación adicionales para su agente de IA a través `llms-install.md` .\n\n### Procedimiento de registro\n\n1. Crear un nuevo problema en [el repositorio de CLINE MCP Marketplace](https://github.com/cline/mcp-marketplace)\n\n2. El número incluye la siguiente información:\n\n * **URL del repositorio de GitHub:** \n * **Imagen del logotipo:** archivo PNG en tamaño 400×400\n * **Razón adicional:** Ejemplo del valor que este servidor MCP puede proporcionar a los usuarios de CLINE: GXP12\n\n3. Comprueba si CLINE puede instalar correctamente un servidor con solo README.md\n\n### Proceso de aprobación\n\n1. El equipo de CLINE revisa los servidores MCP enviados\n2. Estamos realizando una verificación de seguridad y estabilidad.\n3. Una vez aprobado, aparecerá en el Marketplace y será accesible para todos los usuarios de CLINE.\n\n### Guía de instalación optimizada\n\nPuede proporcionar instrucciones de instalación adicionales para su agente de IA creando un archivo `llms-install.md` :\n\n```markdown\n# MCP Gemini 서버 설치 가이드 (AI 에이전트용)\n\n## 환경 요구사항\n- Node.js 18.0.0 이상\n- npm 또는 yarn\n- Google AI Studio API 키\n\n## 설치 단계\n1. 저장소 클론\n2. 의존성 설치: `npm install`\n3. 환경 변수 설정: GOOGLE_API_KEY 추가\n4. 빌드: `npm run build`\n5. 서버 실행: `npm run start`\n\n## 설정 검증\n- 8000번 포트 사용 가능 여부 확인\n- API 키 유효성 검증\n- CORS 설정 확인\n\n## 문제 해결\n- 포트 충돌 시 해결 방법\n- API 키 오류 해결 방법\n- 일반적인 설치 문제 해결 가이드\n```","Spanish","es-ES",{"_34":53,"_38":55,"_43":56},{"_36":37,"_38":39,"_40":54},"# MCP Gemini APIサーバー\n\nCursorとClaude用のGoogle Gemini APIサーバー。テキスト生成、画像分析、ビデオ分析など、Geminiのさまざまな機能を提供します。\n\n## 主な機能\n\n* テキスト生成(gemini-2.0-flashモデルを使用)\n* 画像の生成と分析\n* YouTubeビデオ分析\n* Web検索\n\n## 始める\n\n### 必須要件\n\n* Node.js 18.0.0以降\n* npmまたはyarn\n* Google APIキー（Gemini APIアクセス用）\n\n### インストール\n\n```bash\n# 저장소 클론\ngit clone https://github.com/techkwon/mcp-gemini.git\ncd mcp-gemini\n\n# 의존성 설치\nnpm install\n```\n\n### 環境設定\n\n1. `config.ts`ファイルでGoogle APIキーを設定する：\n\n```typescript\nexport default {\n googleApiKey: \"your_api_key_here\",\n // 기타 설정...\n};\n```\n\n### ビルドと実行\n\n```bash\n# TypeScript 빌드\nnpm run build\n\n# 서버 시작 (PM2 사용)\nnpm start\n\n# 개발 모드로 실행\nnpm run dev\n```\n\n### PM2サーバー管理\n\nサーバーはPM2を介して自動的に管理されます。次のコマンドでサーバーを管理できます。\n\n```bash\n# 서버 상태 확인\nnpm run status\n\n# 서버 로그 확인\nnpm run logs\n\n# 서버 중지\nnpm run stop\n\n# 서버 재시작\nnpm run restart\n\n# 시스템 재시작 시 자동 실행 설정\npm2 startup\npm2 save\n```\n\n## Cursor/Claude 連動\n\n### MCP設定\n\n`~/.cursor/mcp.json`ファイルに次の設定を追加します。\n\n```json\n{\n \"github.com/techkwon/mcp-gemini\": {\n \"command\": \"npm\",\n \"args\": [\"start\"],\n \"cwd\": \"<프로젝트_경로>\",\n \"env\": {\n \"NODE_ENV\": \"production\"\n },\n \"disabled\": false,\n \"autoStart\": true,\n \"autoApprove\": [\n \"gem-generate\",\n \"gem-generate-image\",\n \"gem-analyze-video\",\n \"gem-search\"\n ]\n }\n}\n```\n\n### API エンドポイント\n\n* `/gem-generate` : テキスト生成\n* `/gem-generate-image` : イメージの生成/分析\n* `/gem-analyze-video` ：YouTubeビデオ分析\n* `/gem-search` search : Web 検索\n\n## 主なアップデート\n\n### 最新バージョン(2024-03)\n\n* PM2によるサーバー自動化の実装\n* gemini-2.0-flashモデルで統一\n* 自動再起動とエラー回復機能の追加\n* 環境設定の改善\n\n### 以前のバージョン\n\n* YouTubeビデオ分析機能を追加\n* 画像生成/分析機能の改善\n* ウェブ検索機能の追加\n\n## トラブルシューティング\n\n### 一般的な問題\n\n1. **サーバーが起動しない場合**\n\n ```bash\n # PM2 로그 확인\n npm run logs\n\n # PM2 프로세스 상태 확인\n npm run status\n ```\n\n2. **API キーエラー**\n\n * `config.ts`ファイルでAPIキーが正しく設定されていることを確認する\n * Gemini API クォータと権限の確認\n\n3. **メモリ使用量の問題**\n\n * `ecosystem.config.js`でメモリ制限設定を確認する\n * PM2モニタリングによるメモリ使用量の追跡\n\n## 貢献する\n\n1. Fork the Project\n2. Create your Feature Branch ( `git checkout -b feature/AmazingFeature` )\n3. Commit your Changes ( `git commit -m 'Add some AmazingFeature'` )\n4. Push to the Branch ( `git push origin feature/AmazingFeature` )\n5. Open a Pull Request\n\n## ライセンス\n\nこのプロジェクトはMITライセンスに従います。詳細については、 [LICENSE](LICENSE)ファイルを参照してください。\n\n## お問い合わせ\n\nプロジェクトマネージャ：techkwon Eメール：プロジェクトリンク：https: [//github.com/techkwon/mcp-gemini](https://github.com/techkwon/mcp-gemini)\n\n## 主な依存性\n\n* @google/generative-ai: ^0.1.3 (Gemini API SDK)\n* @fastify/cors: ^8.5.0 (CORS サポート)\n* fastify: ^4.29.0 (ウェブサーバーフレームワーク)\n* googleapis: ^148.0.0 (Google API サポート)\n* typescript: ^5.0.0\n* zod: ^3.24.2 (データ検証)\n* pino: ^8.21.0 (ロギング)\n\n## Claude デスクトップアプリ統合ガイド\n\n### 設定ファイルの場所\n\nClaudeデスクトップアプリの設定ファイルは次のパスにあります。\n\n* Windows: `%APPDATA%/Claude/config.json`\n* macOS: `~/Library/Application Support/Claude/config.json`\n\n### JSON設定の例\n\n```json\n{\n \"apis\": [\n {\n \"name\": \"MCP Gemini\",\n \"url\": \"http://localhost:8000\",\n \"methods\": [\n {\n \"name\": \"텍스트 생성\",\n \"method\": \"gem-generate\",\n \"template\": {\n \"jsonrpc\": \"2.0\",\n \"id\": \"{uuid}\",\n \"method\": \"gem-generate\",\n \"params\": {\n \"prompt\": \"{input}\"\n }\n }\n },\n {\n \"name\": \"이미지 생성\",\n \"method\": \"gem-generate-image\",\n \"template\": {\n \"jsonrpc\": \"2.0\",\n \"id\": \"{uuid}\",\n \"method\": \"gem-generate-image\",\n \"params\": {\n \"prompt\": \"{input}\"\n }\n }\n },\n {\n \"name\": \"비디오 분석\",\n \"method\": \"gem-analyze-video\",\n \"template\": {\n \"jsonrpc\": \"2.0\",\n \"id\": \"{uuid}\",\n \"method\": \"gem-analyze-video\",\n \"params\": {\n \"videoUrl\": \"{input}\",\n \"query\": \"이 영상의 주요 내용을 요약해주세요\"\n }\n }\n },\n {\n \"name\": \"웹 검색\",\n \"method\": \"gem-search\",\n \"template\": {\n \"jsonrpc\": \"2.0\",\n \"id\": \"{uuid}\",\n \"method\": \"gem-search\",\n \"params\": {\n \"query\": \"{input}\"\n }\n }\n }\n ]\n }\n ]\n}\n```\n\n### 変数の説明\n\n* `{uuid}` : 自動生成される一意のリクエスト ID\n* `{input}` ：Claudeチャットウィンドウに入力したテキスト\n\n### 使用方法\n\n1. Claudeデスクトップアプリの設定ファイルを開きます。\n2. 上記のJSON設定を既存の設定に追加します。\n3. Claudeデスクトップアプリを再起動します。\n4. チャットウィンドウで次のように使用できます。\n\n```\n@MCP Gemini.텍스트 생성 한국의 전통 음식에 대해 설명해주세요\n@MCP Gemini.이미지 생성 한옥마을의 아름다운 풍경\n@MCP Gemini.비디오 분석 https://youtube.com/watch?v=VIDEO_ID\n@MCP Gemini.웹 검색 최신 인공지능 기술 동향\n```\n\n### 応答形式\n\nすべてのAPIレスポンスは次の形式に従います。\n\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"id\": \"요청에서 보낸 ID\",\n \"result\": {\n \"content\": \"응답 내용\"\n }\n}\n```\n\n### エラー応答\n\nエラーが発生した場合は、次の形式で応答します。\n\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"id\": \"요청에서 보낸 ID\",\n \"error\": {\n \"code\": 오류코드,\n \"message\": \"오류 메시지\",\n \"data\": {\n \"details\": \"상세 오류 정보\"\n }\n }\n}\n```\n\n## エラー処理\n\nサーバーは、次の状況で適切なエラー応答を返します。\n\n* 400: 誤ったリクエスト形式\n* 401：認証エラー（APIキー関連）\n* 500: サーバー内部エラー\n\n## セキュリティに関する考慮事項\n\n* APIキーは必ず環境変数で管理してください\n* 本番環境では、適切なセキュリティ設定を追加してください\n* 機密情報はログに記録しないように注意してください\n\n## トラブルシューティング\n\n### ポートの競合\n\nすでに8000番ポートが使用されている場合：\n\n```bash\n# 기존 Node.js 프로세스 종료\npkill -f \"node\"\n```\n\n### サーバーの信頼性\n\nサーバーが予期せず終了した場合：\n\n* PM2または他のプロセスマネージャの使用を検討してください\n* ログを確認して終了の原因を特定してください\n\n## 開発ガイド\n\n### ロギング\n\n* Pinoロガーを使用して構造化ロギングを実装しました\n* 開発環境では、pino-prettyを介して読みやすいログが出力されます\n\n### タイプ安定性\n\n* TypeScriptとZodを使用してランタイムタイプの安定性を確保\n* APIリクエスト/レスポンスのスキーマ検証が実装されています\n\n## CLINE MCPマーケットプレイス登録ガイド\n\n### 事前準備\n\n1. GitHubリポジトリが公開されている必要があります\n2. README.mdファイルに明確なインストールと設定方法が含まれている必要があります\n3. （オプション） `llms-install.md`ファイルを使用してAIエージェント用の追加インストールガイドを提供できます。\n\n### 登録手順\n\n1. [CLINE MCPマーケットプレイスストア](https://github.com/cline/mcp-marketplace)に新しい問題を作成します\n\n2. 問題には次の情報が含まれています。\n\n * **GitHubリポジトリURL：** \n * **ロゴ画像：** 400×400サイズのPNGファイル\n * \\*\\*追加の理由：\\*\\*このMCPサーバーがCLINEユーザーに提供できる価値の例：GXP12\n\n3. CLINEがREADME.mdだけでサーバーを正常にインストールできるかどうかをテストします\n\n### 承認手続き\n\n1. CLINEチームが送信したMCPサーバーを確認します\n2. セキュリティと信頼性の検証を進める\n3. 承認されると、マーケットプレイスに登録され、すべてのCLINEユーザーがアクセスできるようになります。\n\n### 設置ガイドの最適化\n\n`llms-install.md`ファイルを生成して、AIエージェント用の追加インストールガイドを提供できます。\n\n```markdown\n# MCP Gemini 서버 설치 가이드 (AI 에이전트용)\n\n## 환경 요구사항\n- Node.js 18.0.0 이상\n- npm 또는 yarn\n- Google AI Studio API 키\n\n## 설치 단계\n1. 저장소 클론\n2. 의존성 설치: `npm install`\n3. 환경 변수 설정: GOOGLE_API_KEY 추가\n4. 빌드: `npm run build`\n5. 서버 실행: `npm run start`\n\n## 설정 검증\n- 8000번 포트 사용 가능 여부 확인\n- API 키 유효성 검증\n- CORS 설정 확인\n\n## 문제 해결\n- 포트 충돌 시 해결 방법\n- API 키 오류 해결 방법\n- 일반적인 설치 문제 해결 가이드\n```","Japanese","ja-JP",{"_34":58,"_38":60,"_43":61},{"_36":37,"_38":39,"_40":59},"# MCP Gemini API 서버\n\nCursor와 Claude를 위한 Google Gemini API 서버입니다. 텍스트 생성, 이미지 분석, 비디오 분석 등 Gemini의 다양한 기능을 제공합니다.\n\n## 주요 기능\n\n- 텍스트 생성 (gemini-2.0-flash 모델 사용)\n- 이미지 생성 및 분석\n- YouTube 비디오 분석\n- 웹 검색\n\n## 시작하기\n\n### 필수 요구사항\n\n- Node.js 18.0.0 이상\n- npm 또는 yarn\n- Google API 키 (Gemini API 접근용)\n\n### 설치\n\n```bash\n# 저장소 클론\ngit clone https://github.com/techkwon/mcp-gemini.git\ncd mcp-gemini\n\n# 의존성 설치\nnpm install\n```\n\n### 환경 설정\n\n1. `config.ts` 파일에 Google API 키 설정:\n\n```typescript\nexport default {\n googleApiKey: \"your_api_key_here\",\n // 기타 설정...\n};\n```\n\n### 빌드 및 실행\n\n```bash\n# TypeScript 빌드\nnpm run build\n\n# 서버 시작 (PM2 사용)\nnpm start\n\n# 개발 모드로 실행\nnpm run dev\n```\n\n### PM2 서버 관리\n\n서버는 PM2를 통해 자동으로 관리됩니다. 다음 명령어로 서버를 관리할 수 있습니다:\n\n```bash\n# 서버 상태 확인\nnpm run status\n\n# 서버 로그 확인\nnpm run logs\n\n# 서버 중지\nnpm run stop\n\n# 서버 재시작\nnpm run restart\n\n# 시스템 재시작 시 자동 실행 설정\npm2 startup\npm2 save\n```\n\n## Cursor/Claude 연동\n\n### MCP 설정\n\n`~/.cursor/mcp.json` 파일에 다음 설정을 추가하세요:\n\n```json\n{\n \"github.com/techkwon/mcp-gemini\": {\n \"command\": \"npm\",\n \"args\": [\"start\"],\n \"cwd\": \"<프로젝트_경로>\",\n \"env\": {\n \"NODE_ENV\": \"production\"\n },\n \"disabled\": false,\n \"autoStart\": true,\n \"autoApprove\": [\n \"gem-generate\",\n \"gem-generate-image\",\n \"gem-analyze-video\",\n \"gem-search\"\n ]\n }\n}\n```\n\n### API 엔드포인트\n\n- `/gem-generate`: 텍스트 생성\n- `/gem-generate-image`: 이미지 생성/분석\n- `/gem-analyze-video`: YouTube 비디오 분석\n- `/gem-search`: 웹 검색\n\n## 주요 업데이트\n\n### 최신 버전 (2024-03)\n- PM2를 통한 서버 자동화 구현\n- gemini-2.0-flash 모델로 통일\n- 자동 재시작 및 오류 복구 기능 추가\n- 환경 설정 개선\n\n### 이전 버전\n- YouTube 비디오 분석 기능 추가\n- 이미지 생성/분석 기능 개선\n- 웹 검색 기능 추가\n\n## 문제 해결\n\n### 일반적인 문제\n\n1. **서버가 시작되지 않는 경우**\n ```bash\n # PM2 로그 확인\n npm run logs\n \n # PM2 프로세스 상태 확인\n npm run status\n ```\n\n2. **API 키 오류**\n - `config.ts` 파일에서 API 키가 올바르게 설정되었는지 확인\n - Gemini API 할당량 및 권한 확인\n\n3. **메모리 사용량 문제**\n - `ecosystem.config.js`에서 메모리 제한 설정 확인\n - PM2 모니터링으로 메모리 사용량 추적\n\n## 기여하기\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## 라이선스\n\n이 프로젝트는 MIT 라이선스를 따릅니다. 자세한 내용은 [LICENSE](LICENSE) 파일을 참조하세요.\n\n## 연락처\n\n프로젝트 관리자: techkwon\n이메일: techkwon@example.com\n프로젝트 링크: [https://github.com/techkwon/mcp-gemini](https://github.com/techkwon/mcp-gemini)\n\n## 주요 의존성\n\n- @google/generative-ai: ^0.1.3 (Gemini API SDK)\n- @fastify/cors: ^8.5.0 (CORS 지원)\n- fastify: ^4.29.0 (웹 서버 프레임워크)\n- googleapis: ^148.0.0 (Google API 지원)\n- typescript: ^5.0.0\n- zod: ^3.24.2 (데이터 검증)\n- pino: ^8.21.0 (로깅)\n\n## Claude 데스크톱 앱 통합 가이드\n\n### 설정 파일 위치\nClaude 데스크톱 앱의 설정 파일은 다음 경로에 위치합니다:\n- Windows: `%APPDATA%/Claude/config.json`\n- macOS: `~/Library/Application Support/Claude/config.json`\n\n### JSON 설정 예시\n\n```json\n{\n \"apis\": [\n {\n \"name\": \"MCP Gemini\",\n \"url\": \"http://localhost:8000\",\n \"methods\": [\n {\n \"name\": \"텍스트 생성\",\n \"method\": \"gem-generate\",\n \"template\": {\n \"jsonrpc\": \"2.0\",\n \"id\": \"{uuid}\",\n \"method\": \"gem-generate\",\n \"params\": {\n \"prompt\": \"{input}\"\n }\n }\n },\n {\n \"name\": \"이미지 생성\",\n \"method\": \"gem-generate-image\",\n \"template\": {\n \"jsonrpc\": \"2.0\",\n \"id\": \"{uuid}\",\n \"method\": \"gem-generate-image\",\n \"params\": {\n \"prompt\": \"{input}\"\n }\n }\n },\n {\n \"name\": \"비디오 분석\",\n \"method\": \"gem-analyze-video\",\n \"template\": {\n \"jsonrpc\": \"2.0\",\n \"id\": \"{uuid}\",\n \"method\": \"gem-analyze-video\",\n \"params\": {\n \"videoUrl\": \"{input}\",\n \"query\": \"이 영상의 주요 내용을 요약해주세요\"\n }\n }\n },\n {\n \"name\": \"웹 검색\",\n \"method\": \"gem-search\",\n \"template\": {\n \"jsonrpc\": \"2.0\",\n \"id\": \"{uuid}\",\n \"method\": \"gem-search\",\n \"params\": {\n \"query\": \"{input}\"\n }\n }\n }\n ]\n }\n ]\n}\n```\n\n### 변수 설명\n\n- `{uuid}`: 자동으로 생성되는 고유 요청 ID\n- `{input}`: Claude 채팅창에 입력한 텍스트\n\n### 사용 방법\n\n1. Claude 데스크톱 앱의 설정 파일을 엽니다.\n2. 위의 JSON 설정을 기존 설정에 추가합니다.\n3. Claude 데스크톱 앱을 재시작합니다.\n4. 채팅창에서 다음과 같이 사용할 수 있습니다:\n\n```\n@MCP Gemini.텍스트 생성 한국의 전통 음식에 대해 설명해주세요\n@MCP Gemini.이미지 생성 한옥마을의 아름다운 풍경\n@MCP Gemini.비디오 분석 https://youtube.com/watch?v=VIDEO_ID\n@MCP Gemini.웹 검색 최신 인공지능 기술 동향\n```\n\n### 응답 형식\n\n모든 API 응답은 다음 형식을 따릅니다:\n\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"id\": \"요청에서 보낸 ID\",\n \"result\": {\n \"content\": \"응답 내용\"\n }\n}\n```\n\n### 오류 응답\n\n오류가 발생한 경우 다음 형식으로 응답합니다:\n\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"id\": \"요청에서 보낸 ID\",\n \"error\": {\n \"code\": 오류코드,\n \"message\": \"오류 메시지\",\n \"data\": {\n \"details\": \"상세 오류 정보\"\n }\n }\n}\n```\n\n## 오류 처리\n\n서버는 다음과 같은 상황에서 적절한 오류 응답을 반환합니다:\n\n- 400: 잘못된 요청 형식\n- 401: 인증 오류 (API 키 관련)\n- 500: 서버 내부 오류\n\n## 보안 고려사항\n\n- API 키는 반드시 환경 변수로 관리하세요\n- 프로덕션 환경에서는 적절한 보안 설정을 추가하세요\n- 민감한 정보는 로그에 기록하지 않도록 주의하세요\n\n## 문제 해결\n\n### 포트 충돌\n이미 8000번 포트가 사용 중인 경우:\n```bash\n# 기존 Node.js 프로세스 종료\npkill -f \"node\"\n```\n\n### 서버 안정성\n서버가 예기치 않게 종료되는 경우:\n- PM2나 다른 프로세스 관리자 사용을 고려하세요\n- 로그를 확인하여 종료 원인을 파악하세요\n\n## 개발 가이드\n\n### 로깅\n- Pino 로거를 사용하여 구조화된 로깅을 구현했습니다\n- 개발 환경에서는 pino-pretty를 통해 가독성 있는 로그가 출력됩니다\n\n### 타입 안정성\n- TypeScript와 Zod를 사용하여 런타임 타입 안정성을 보장합니다\n- API 요청/응답에 대한 스키마 검증이 구현되어 있습니다\n\n## CLINE MCP 마켓플레이스 등록 가이드\n\n### 사전 준비사항\n\n1. GitHub 저장소가 공개되어 있어야 합니다\n2. README.md 파일에 명확한 설치 및 설정 방법이 포함되어 있어야 합니다\n3. (선택사항) `llms-install.md` 파일을 통해 AI 에이전트를 위한 추가 설치 가이드를 제공할 수 있습니다\n\n### 등록 절차\n\n1. [CLINE MCP 마켓플레이스 저장소](https://github.com/cline/mcp-marketplace)에 새로운 이슈를 생성합니다\n\n2. 이슈에 다음 정보를 포함합니다:\n - **GitHub 저장소 URL:** https://github.com/techkwon/mcp-gemini\n - **로고 이미지:** 400×400 크기의 PNG 파일\n - **추가 이유:** 이 MCP 서버가 CLINE 사용자들에게 제공할 수 있는 가치\n 예시:\n ```markdown\n ## MCP Gemini 서버 등록 요청\n \n ### GitHub 저장소\n https://github.com/techkwon/mcp-gemini\n \n ### 주요 기능\n - Gemini API를 활용한 텍스트 생성\n - 이미지 생성 및 편집 (gemini-2.0-flash-exp 모델 사용)\n - YouTube 비디오 콘텐츠 분석\n - 웹 검색 기능\n \n ### 사용자 이점\n - 최신 Gemini 모델을 MCP 프로토콜을 통해 쉽게 활용\n - 다양한 미디어 형식(텍스트, 이미지, 비디오) 처리 가능\n - 명확한 JSON-RPC 인터페이스로 쉬운 통합\n - 상세한 문서화와 예제 제공\n ```\n\n3. CLINE이 README.md만으로 서버를 성공적으로 설치할 수 있는지 테스트합니다\n\n### 승인 절차\n\n1. CLINE 팀이 제출된 MCP 서버를 검토합니다\n2. 보안 및 안정성 검증을 진행합니다\n3. 승인되면 마켓플레이스에 등록되어 모든 CLINE 사용자가 접근할 수 있게 됩니다\n\n### 설치 가이드 최적화\n\n`llms-install.md` 파일을 생성하여 AI 에이전트를 위한 추가 설치 가이드를 제공할 수 있습니다:\n\n```markdown\n# MCP Gemini 서버 설치 가이드 (AI 에이전트용)\n\n## 환경 요구사항\n- Node.js 18.0.0 이상\n- npm 또는 yarn\n- Google AI Studio API 키\n\n## 설치 단계\n1. 저장소 클론\n2. 의존성 설치: `npm install`\n3. 환경 변수 설정: GOOGLE_API_KEY 추가\n4. 빌드: `npm run build`\n5. 서버 실행: `npm run start`\n\n## 설정 검증\n- 8000번 포트 사용 가능 여부 확인\n- API 키 유효성 검증\n- CORS 설정 확인\n\n## 문제 해결\n- 포트 충돌 시 해결 방법\n- API 키 오류 해결 방법\n- 일반적인 설치 문제 해결 가이드\n``` ","Korean","ko-KR",{"_34":63,"_38":67,"_43":68},{"_36":64,"_38":65,"_40":66},"通过 MCP 协议提供对 Google Gemini AI 功能（包括文本生成、图像分析、YouTube 视频分析和网络搜索功能）的访问的服务器。","MCP Gemini API 服务器","# MCP Gemini API 服务器\n\n适用于 Cursor 和 Claude 的 Google Gemini API 服务器。 Gemini 提供多种功能，包括文本生成、图像分析和视频分析。\n\n## 主要特点\n\n* 文本生成（使用gemini-2.0-flash模型）\n* 图像创建和分析\n* YouTube 视频分析\n* 网络搜索\n\n## 开始\n\n### 基本要求\n\n* Node.js 18.0.0 或更高版本\n* npm 或 yarn\n* Google API 密钥（用于访问 Gemini API）\n\n### 安装\n\n```bash\n# 저장소 클론\ngit clone https://github.com/techkwon/mcp-gemini.git\ncd mcp-gemini\n\n# 의존성 설치\nnpm install\n```\n\n### 偏好设置\n\n1. 在`config.ts`文件中设置您的 Google API 密钥：\n\n```typescript\nexport default {\n googleApiKey: \"your_api_key_here\",\n // 기타 설정...\n};\n```\n\n### 构建并运行\n\n```bash\n# TypeScript 빌드\nnpm run build\n\n# 서버 시작 (PM2 사용)\nnpm start\n\n# 개발 모드로 실행\nnpm run dev\n```\n\n### PM2 服务器管理\n\n服务器通过 PM2 自动管理。您可以使用以下命令管理您的服务器：\n\n```bash\n# 서버 상태 확인\nnpm run status\n\n# 서버 로그 확인\nnpm run logs\n\n# 서버 중지\nnpm run stop\n\n# 서버 재시작\nnpm run restart\n\n# 시스템 재시작 시 자동 실행 설정\npm2 startup\npm2 save\n```\n\n## Cursor/Claude 集成\n\n### MCP 设置\n\n将以下设置添加到您的`~/.cursor/mcp.json`文件：\n\n```json\n{\n \"github.com/techkwon/mcp-gemini\": {\n \"command\": \"npm\",\n \"args\": [\"start\"],\n \"cwd\": \"<프로젝트_경로>\",\n \"env\": {\n \"NODE_ENV\": \"production\"\n },\n \"disabled\": false,\n \"autoStart\": true,\n \"autoApprove\": [\n \"gem-generate\",\n \"gem-generate-image\",\n \"gem-analyze-video\",\n \"gem-search\"\n ]\n }\n}\n```\n\n### API 端点\n\n* `/gem-generate` ：生成文本\n* `/gem-generate-image` ：图像生成/分析\n* `/gem-analyze-video` ：分析 YouTube 视频\n* `/gem-search` ：网页搜索\n\n## 重大更新\n\n### 最新版本（2024-03）\n\n* 通过 PM2 实现服务器自动化\n* 统一到 gemini-2.0-flash 模型\n* 增加了自动重启和错误恢复功能\n* 改善您的设置\n\n### 先前版本\n\n* 添加了 YouTube 视频分析功能\n* 改进的图像创建/分析能力\n* 添加网页搜索功能\n\n## 故障排除\n\n### 常见问题\n\n1. **如果服务器没有启动**\n\n ```bash\n # PM2 로그 확인\n npm run logs\n\n # PM2 프로세스 상태 확인\n npm run status\n ```\n\n2. **API 密钥错误**\n\n * 确保您的 API 密钥在`config.ts`文件中设置正确。\n * 检查 Gemini API 配额和权限\n\n3. **内存使用问题**\n\n * 检查`ecosystem.config.js`中的内存限制设置\n * 使用 PM2 监控跟踪内存使用情况\n\n## 贡献\n\n1. 分叉项目\n2. 创建你的功能分支（ `git checkout -b feature/AmazingFeature` ）\n3. 提交您的更改（ `git commit -m 'Add some AmazingFeature'` ）\n4. 推送到分支（ `git push origin feature/AmazingFeature` ）\n5. 打开拉取请求\n\n## 执照\n\n该项目遵循 MIT 许可证。请参阅[LICENSE](LICENSE)文件以了解详细信息。\n\n## 接触\n\n项目经理：techkwon 电子邮件：项目链接： \n\n## 关键依赖关系\n\n* @google/generative-ai：^0.1.3（Gemini API SDK）\n* @fastify/cors：^8.5.0（CORS 支持）\n* fastify：^4.29.0（Web 服务器框架）\n* googleapis：^148.0.0（Google API 支持）\n* 打字稿：^5.0.0\n* zod：^3.24.2（数据验证）\n* pino: ^8.21.0 (日志记录)\n\n## Claude 桌面应用程序集成指南\n\n### 设置文件位置\n\nClaude 桌面应用程序的设置文件位于以下路径：\n\n* Windows： `%APPDATA%/Claude/config.json`\n* macOS： `~/Library/Application Support/Claude/config.json`\n\n### JSON 设置示例\n\n```json\n{\n \"apis\": [\n {\n \"name\": \"MCP Gemini\",\n \"url\": \"http://localhost:8000\",\n \"methods\": [\n {\n \"name\": \"텍스트 생성\",\n \"method\": \"gem-generate\",\n \"template\": {\n \"jsonrpc\": \"2.0\",\n \"id\": \"{uuid}\",\n \"method\": \"gem-generate\",\n \"params\": {\n \"prompt\": \"{input}\"\n }\n }\n },\n {\n \"name\": \"이미지 생성\",\n \"method\": \"gem-generate-image\",\n \"template\": {\n \"jsonrpc\": \"2.0\",\n \"id\": \"{uuid}\",\n \"method\": \"gem-generate-image\",\n \"params\": {\n \"prompt\": \"{input}\"\n }\n }\n },\n {\n \"name\": \"비디오 분석\",\n \"method\": \"gem-analyze-video\",\n \"template\": {\n \"jsonrpc\": \"2.0\",\n \"id\": \"{uuid}\",\n \"method\": \"gem-analyze-video\",\n \"params\": {\n \"videoUrl\": \"{input}\",\n \"query\": \"이 영상의 주요 내용을 요약해주세요\"\n }\n }\n },\n {\n \"name\": \"웹 검색\",\n \"method\": \"gem-search\",\n \"template\": {\n \"jsonrpc\": \"2.0\",\n \"id\": \"{uuid}\",\n \"method\": \"gem-search\",\n \"params\": {\n \"query\": \"{input}\"\n }\n }\n }\n ]\n }\n ]\n}\n```\n\n### 变量描述\n\n* `{uuid}` ：自动生成的唯一请求ID。\n* `{input}` ：输入到 Claude 聊天窗口的文本\n\n### 如何使用\n\n1. 打开 Claude 桌面应用程序的设置文件。\n2. 将上面的 JSON 设置添加到您现有的设置中。\n3. 重新启动 Claude 桌面应用程序。\n4. 您可以在聊天窗口中使用它，如下所示：\n\n```\n@MCP Gemini.텍스트 생성 한국의 전통 음식에 대해 설명해주세요\n@MCP Gemini.이미지 생성 한옥마을의 아름다운 풍경\n@MCP Gemini.비디오 분석 https://youtube.com/watch?v=VIDEO_ID\n@MCP Gemini.웹 검색 최신 인공지능 기술 동향\n```\n\n### 响应格式\n\n所有 API 响应都遵循以下格式：\n\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"id\": \"요청에서 보낸 ID\",\n \"result\": {\n \"content\": \"응답 내용\"\n }\n}\n```\n\n### 错误响应\n\n如果发生错误，请按照以下格式进行响应：\n\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"id\": \"요청에서 보낸 ID\",\n \"error\": {\n \"code\": 오류코드,\n \"message\": \"오류 메시지\",\n \"data\": {\n \"details\": \"상세 오류 정보\"\n }\n }\n}\n```\n\n## 错误处理\n\n在以下情况下，服务器将返回适当的错误响应：\n\n* 400：错误的请求格式\n* 401：身份验证错误（API 密钥相关）\n* 500：内部服务器错误\n\n## 安全注意事项\n\n* 确保将您的 API 密钥作为环境变量进行管理。\n* 在生产环境中，添加适当的安全设置。\n* 注意不要记录敏感信息。\n\n## 故障排除\n\n### 端口冲突\n\n如果端口 8000 已被使用：\n\n```bash\n# 기존 Node.js 프로세스 종료\npkill -f \"node\"\n```\n\n### 服务器稳定性\n\n如果服务器意外终止：\n\n* 考虑使用 PM2 或其他进程管理器。\n* 检查日志以确定终止的原因。\n\n## 开发指南\n\n### 日志记录\n\n* 使用 Pino logger 实现结构化日志记录\n* 在开发环境中，通过 pino-pretty 输出可读的日志。\n\n### 类型安全\n\n* 使用 TypeScript 和 Zod 确保运行时类型安全\n* 已实现 API 请求/响应的模式验证。\n\n## CLINE MCP 市场注册指南\n\n### 前期准备\n\n1. 您的 GitHub 存储库必须是公开的\n2. README.md 文件应包含清晰的安装和设置说明。\n3. （可选）您可以通过`llms-install.md`文件为您的 AI 代理提供额外的安装说明。\n\n### 注册程序\n\n1. 在[CLINE MCP Marketplace 存储库](https://github.com/cline/mcp-marketplace)中创建新问题\n\n2. 该问题包含以下信息：\n\n * **GitHub 仓库网址：** \n * **徽标图像：** PNG文件，尺寸为400×400\n * \\*\\*附加原因：\\*\\*此 MCP 服务器可以为 CLINE 用户提供的价值示例：GXP12\n\n3. 测试 CLINE 是否能仅使用 README.md 成功安装服务器\n\n### 审批流程\n\n1. CLINE 团队审查已提交的 MCP 服务器\n2. 我们正在进行安全性和稳定性验证\n3. 一旦获得批准，您将被列入市场并可供所有 CLINE 用户访问。\n\n### 优化安装指南\n\n您可以通过创建`llms-install.md`文件为您的 AI 代理提供额外的安装说明：\n\n```markdown\n# MCP Gemini 서버 설치 가이드 (AI 에이전트용)\n\n## 환경 요구사항\n- Node.js 18.0.0 이상\n- npm 또는 yarn\n- Google AI Studio API 키\n\n## 설치 단계\n1. 저장소 클론\n2. 의존성 설치: `npm install`\n3. 환경 변수 설정: GOOGLE_API_KEY 추가\n4. 빌드: `npm run build`\n5. 서버 실행: `npm run start`\n\n## 설정 검증\n- 8000번 포트 사용 가능 여부 확인\n- API 키 유효성 검증\n- CORS 설정 확인\n\n## 문제 해결\n- 포트 충돌 시 해결 방법\n- API 키 오류 해결 방법\n- 일반적인 설치 문제 해결 가이드\n```","Chinese","zh-CN","githubUser","locale",{"_72":73,"_20":74,"_82":37,"_83":37,"_23":84,"_85":86,"_38":39,"_104":105,"_112":-5,"_113":-5,"_114":115,"_151":152,"_157":-5,"_93":132,"_158":159,"_8":160,"_161":162},"addedAt","2025-03-30T14:02:26.861680Z",[75,76,77,78,79,80,81],"category:rag-systems","category:search","environment:network","hosting:hybrid","language:typescript","security_grade:a","quality_grade:a","descriptionMarkdown","descriptionPlainText",4130,"integrations",[87,97],{"_88":89,"_36":95,"_8":96},"brand",{"_90":91,"_38":92,"_93":94},"logoSvgPath","M11.04 19.32Q12 21.51 12 24q0-2.49.93-4.68.96-2.19 2.58-3.81t3.81-2.55Q21.51 12 24 12q-2.49 0-4.68-.93a12.3 12.3 0 0 1-3.81-2.58 12.3 12.3 0 0 1-2.58-3.81Q12 2.49 12 0q0 2.49-.96 4.68-.93 2.19-2.55 3.81a12.3 12.3 0 0 1-3.81 2.58Q2.49 12 0 12q2.49 0 4.68.96 2.19.93 3.81 2.55t2.55 3.81","Google Gemini","slug","google-gemini","Implements a bridge to Google Gemini's API, enabling text generation with gemini-2.0-flash model, image generation/analysis, and multimodal content processing","wjxj1yy0e9",{"_88":98,"_36":102,"_8":103},{"_90":99,"_38":100,"_93":101},"M23.498 6.186a3.016 3.016 0 0 0-2.122-2.136C19.505 3.545 12 3.545 12 3.545s-7.505 0-9.377.505A3.017 3.017 0 0 0 .502 6.186C0 8.07 0 12 0 12s0 3.93.502 5.814a3.016 3.016 0 0 0 2.122 2.136c1.871.505 9.376.505 9.376.505s7.505 0 9.377-.505a3.015 3.015 0 0 0 2.122-2.136C24 15.93 24 12 24 12s0-3.93-.502-5.814zM9.545 15.568V8.432L15.818 12l-6.273 3.568z","YouTube","youtube","Offers video content analysis functionality by processing YouTube videos and providing summaries or answers to queries about video content","stdlwdkh0m","namespace",{"_106":107,"_93":111},"owner",{"_108":109},"githubAccount",{"_110":111},"login","techkwon","readmeMarkdown","redditPostExternalId","repository",{"_116":-5,"_117":118,"_121":122,"_140":-5,"_141":142,"_143":144,"_147":148},"argumentsJsonSchema","githubProject",{"_40":59,"_119":120},"url","https://github.com/techkwon/mcp-gemini","githubRepository",{"_123":124,"_125":126,"_127":128,"_23":129,"_130":131,"_38":132,"_106":133,"_135":136,"_137":-5,"_138":139},"defaultBranch","master","fullName","techkwon/mcp-gemini","githubTreeId",279028,7048,"language","TypeScript","mcp-gemini",{"_110":111,"_8":134},"0CMs7bfq2S","recentStargazers",0,"spdxLicense","stargazers",4,"glamaJson","inspectable",true,"npmPackage",{"_38":132,"_145":146},"weeklyDownloads",1,"supportedPlatforms",[149,150],"WINDOWS","MACOS","scores",{"_153":-5,"_154":155,"_156":155},"license","quality",100,"security","simpleIcon","toolCount",6,"vuqk58ui8u","updatedAt","2025-10-01T12:51:01.126710Z","meta",[165,167,169,176,179,181,184,187,190,193,196,198,201,204,206,208,210,212,214],{"_10":166},"MCP Gemini API Server | Glama",{"_168":37,"_38":36},"content",{"_170":171,"_172":173,"_174":175},"href","https://glama.ai/mcp/servers/@techkwon/mcp-gemini","rel","canonical","tagName","link",{"_168":39,"_177":178},"property","og:title",{"_168":37,"_177":180},"og:description",{"_168":182,"_177":183},"https://glama.ai/logo.png","og:logo",{"_168":185,"_177":186},"https://glama.ai/mcp/servers/@techkwon/mcp-gemini/og-image","og:image",{"_168":188,"_177":189},"630","og:image:height",{"_168":191,"_177":192},"1200","og:image:width",{"_168":194,"_177":195},"website","og:type",{"_168":171,"_177":197},"og:url",{"_168":199,"_177":200},"Glama – MCP Hosting Platform","og:site_name",{"_168":202,"_38":203},"summary_large_image","twitter:card",{"_168":199,"_38":205},"twitter:title",{"_168":37,"_38":207},"twitter:description",{"_168":185,"_38":209},"twitter:image",{"_168":188,"_38":211},"twitter:image:height",{"_168":191,"_38":213},"twitter:image:width",{"_215":216},"script:ld+json",{"_217":218,"_219":220},"@context","http://schema.org","@graph",[221],{"_217":222,"_223":224,"_225":226},"https://schema.org","@type","BreadcrumbList","itemListElement",[227,233,237,241],{"_223":228,"_229":230,"_38":231,"_232":146},"ListItem","item","/","Glama","position",{"_223":228,"_229":234,"_38":235,"_232":236},"/mcp","MCP",2,{"_223":228,"_229":238,"_38":239,"_232":240},"/mcp/servers","Servers",3,{"_223":228,"_229":242,"_38":39,"_232":139},"/mcp/servers/@techkwon/mcp-gemini","visitorIsMaintainer",false,"routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~commit/~/_route",{"_247":248,"_34":254,"_271":272,"_163":283,"_281":307,"_308":309},"blob",{"_168":249,"_250":251,"_252":253},"# Server Configuration\nPORT=8000\nHOST=0.0.0.0\nNODE_ENV=development\n\n# API Keys\nGOOGLE_API_KEY=your-google-api-key-here\nYOUTUBE_API_KEY=your-youtube-api-key-here\n\n# Logging\nLOG_LEVEL=debug ","fileName",".env.example","size",188,{"_72":73,"_20":255,"_82":37,"_83":37,"_23":84,"_85":256,"_38":39,"_104":261,"_112":-5,"_113":-5,"_114":264,"_151":270,"_157":-5,"_93":132,"_158":159,"_8":160,"_161":162},[75,76,77,78,79,80,81],[257,259],{"_88":258,"_36":95,"_8":96},{"_90":91,"_38":92,"_93":94},{"_88":260,"_36":102,"_8":103},{"_90":99,"_38":100,"_93":101},{"_106":262,"_93":111},{"_108":263},{"_110":111},{"_116":-5,"_117":265,"_121":266,"_140":-5,"_141":142,"_143":268,"_147":269},{"_40":59,"_119":120},{"_123":124,"_125":126,"_127":128,"_23":129,"_130":131,"_38":132,"_106":267,"_135":136,"_137":-5,"_138":139},{"_110":111,"_8":134},{"_38":132,"_145":146},[149,150],{"_153":-5,"_154":155,"_156":155},"member",{"_273":274,"_277":278,"_279":251,"_127":128,"_280":244,"_281":251,"_282":142,"_252":253,"_12":247},"commit",{"_275":276},"sha","a3479a259541499ea17a370c9cbe0e4ae2cb1f7d","contentStoredObjectPointerId",9985504,"fullPath","indexable","path","safeToDisplayAsText",[284,286,288,290,292,293,294,296,297,298,299,300,301,302,303,304,305,306],{"_10":285},".env.example | MCP Gemini API Server | Glama",{"_168":287,"_38":36},"Enterprise-grade security, privacy, and features like agents, MCP, prompt templates, and more.",{"_170":289,"_172":173,"_174":175},"https://glama.ai/mcp/servers/@techkwon/mcp-gemini/blob/a3479a259541499ea17a370c9cbe0e4ae2cb1f7d/",{"_168":291,"_177":178},".env.example | MCP Gemini API Server",{"_168":287,"_177":180},{"_168":182,"_177":183},{"_168":295,"_177":186},"https://glama.ai/generated-images/og?title=.env.example+%7C+MCP+Gemini+API+Server",{"_168":188,"_177":189},{"_168":191,"_177":192},{"_168":194,"_177":195},{"_168":289,"_177":197},{"_168":199,"_177":200},{"_168":202,"_38":203},{"_168":199,"_38":205},{"_168":287,"_38":207},{"_168":295,"_38":209},{"_168":188,"_38":211},{"_168":191,"_38":213},"","treeMembers",[310,314,317,319,322,325,328,331,334,337],{"_273":311,"_279":312,"_281":312,"_12":313},{"_275":276},"src","tree",{"_273":315,"_279":316,"_281":316,"_12":247},{"_275":276},"ecosystem.config.js",{"_273":318,"_279":251,"_281":251,"_12":247},{"_275":276},{"_273":320,"_279":321,"_281":321,"_12":247},{"_275":276},".gitignore",{"_273":323,"_279":324,"_281":324,"_12":247},{"_275":276},"llms-install.md",{"_273":326,"_279":327,"_281":327,"_12":247},{"_275":276},"mcp-gemini-prd.md",{"_273":329,"_279":330,"_281":330,"_12":247},{"_275":276},"package.json",{"_273":332,"_279":333,"_281":333,"_12":247},{"_275":276},"package-lock.json",{"_273":335,"_279":336,"_281":336,"_12":247},{"_275":276},"README.md",{"_273":338,"_279":339,"_281":339,"_12":247},{"_275":276},"tsconfig.json","actionData","errors"]

MCP directory API