MCP Gemini API 服务器

这是一个为 Cursor 和 Claude 设计的 Google Gemini API 服务器。它提供了 Gemini 的多种功能，包括文本生成、图像分析、视频分析等。

主要功能

• 文本生成（使用 gemini-2.0-flash 模型）
• 图像生成与分析
• YouTube 视频分析
• 网络搜索

开始使用

必要条件

• 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

使用 PM2 管理服务器

服务器通过 PM2 自动管理。可以使用以下命令来管理服务器：

# 서버 상태 확인
npm run status

# 서버 로그 확인
npm run logs

# 서버 중지
npm run stop

# 서버 재시작
npm run restart

# 시스템 재시작 시 자동 실행 설정
pm2 startup
pm2 save

Cursor/Claude 集成

MCP 设置

在 ~/.cursor/mcp.json 文件中添加以下设置：

{
  "github.com/techkwon/mcp-gemini": {
    "command": "npm",
    "args": ["start"],
    "cwd": "<프로젝트_경로>",
    "env": {
      "NODE_ENV": "production"
    },
    "disabled": false,
    "autoStart": true,
    "autoApprove": [
      "gem-generate",
      "gem-generate-image",
      "gem-analyze-video",
      "gem-search"
    ]
  }
}

API 端点

• /gem-generate: 文本生成
• /gem-generate-image: 图像生成/分析
• /gem-analyze-video: YouTube 视频分析
• /gem-search: 网络搜索

主要更新

最新版本 (2024-03)

• 实现了通过 PM2 进行服务器自动化
• 统一使用 gemini-2.0-flash 模型
• 添加自动重启和错误恢复功能
• 改进环境设置

旧版本

• 增加了 YouTube 视频分析功能
• 改进了图像生成/分析功能
• 添加了网络搜索功能

故障排除

常见问题

1. 服务器无法启动时

   # 查看 PM2 日志
   npm run logs
   
   # 检查 PM2 进程状态
   npm run status
   

2. API 密钥错误

   • 确认 config.ts 文件中的 API 密钥是否正确设置
   • 检查 Gemini API 配额和权限

3. 内存使用问题

   • 检查 ecosystem.config.js 中的内存限制设置
   • 使用 PM2 监控跟踪内存使用情况

贡献

1. Fork 项目
2. 创建你的特性分支 (git checkout -b feature/AmazingFeature)
3. 提交你的更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 打开一个 Pull Request

许可证

此项目遵循 MIT 许可证。更多详情请参阅 LICENSE 文件。

联系方式

项目管理员: techkwon
电子邮件: techkwon@example.com
项目链接: https://github.com/techkwon/mcp-gemini

主要依赖项

• @google/generative-ai: ^0.1.3 (Gemini API SDK)
• @fastify/cors: ^8.5.0 (CORS 支持)
• fastify: ^4.29.0 (Web 服务器框架)
• googleapis: ^148.0.0 (Google API 支持)
• typescript: ^5.0.0
• zod: ^3.24.2 (数据验证)
• pino: ^8.21.0 (日志记录)

Claude 桌面应用集成指南

配置文件位置

Claude 桌面应用的配置文件位于：

• Windows: %APPDATA%/Claude/config.json
• macOS: ~/Library/Application Support/Claude/config.json

JSON 配置示例

{
  "apis": [
    {
      "name": "MCP Gemini",
      "url": "http://localhost:8000",
      "methods": [
        {
          "name": "텍스트 생성",
          "method": "gem-generate",
          "template": {
            "jsonrpc": "2.0",
            "id": "{uuid}",
            "method": "gem-generate",
            "params": {
              "prompt": "{input}"
            }
          }
        },
        {
          "name": "이미지 생성",
          "method": "gem-generate-image",
          "template": {
            "jsonrpc": "2.0",
            "id": "{uuid}",
            "method": "gem-generate-image",
            "params": {
              "prompt": "{input}"
            }
          }
        },
        {
          "name": "비디오 분석",
          "method": "gem-analyze-video",
          "template": {
            "jsonrpc": "2.0",
            "id": "{uuid}",
            "method": "gem-analyze-video",
            "params": {
              "videoUrl": "{input}",
              "query": "이 영상의 주요 내용을 요약해주세요"
            }
          }
        },
        {
          "name": "웹 검색",
          "method": "gem-search",
          "template": {
            "jsonrpc": "2.0",
            "id": "{uuid}",
            "method": "gem-search",
            "params": {
              "query": "{input}"
            }
          }
        }
      ]
    }
  ]
}

变量说明

• {uuid}: 自动生成的唯一请求 ID
• {input}: 在 Claude 聊天窗口中输入的文本

使用方法

1. 打开 Claude 桌面应用的配置文件。
2. 将上述 JSON 配置添加到现有设置中。
3. 重启 Claude 桌面应用。
4. 在聊天窗口中可以这样使用：

@MCP Gemini.텍스트 생성 한국의 전통 음식에 대해 설명해주세요
@MCP Gemini.이미지 생성 한옥마을의 아름다운 풍경
@MCP Gemini.비디오 분석 https://youtube.com/watch?v=VIDEO_ID
@MCP Gemini.웹 검색 최신 인공지능 기술 동향

响应格式

所有 API 响应都遵循以下格式：

{
  "jsonrpc": "2.0",
  "id": "요청에서 보낸 ID",
  "result": {
    "content": "응답 내용"
  }
}

错误响应

如果发生错误，将按以下格式响应：

{
  "jsonrpc": "2.0",
  "id": "요청에서 보낸 ID",
  "error": {
    "code": 오류코드,
    "message": "오류 메시지",
    "data": {
      "details": "상세 오류 정보"
    }
  }
}

错误处理

服务器在以下情况下返回适当的错误响应：

• 400: 请求格式错误
• 401: 认证错误（与 API 密钥相关）
• 500: 服务器内部错误

安全考虑

• 一定要通过环境变量管理 API 密钥
• 在生产环境中添加适当的安全设置
• 注意不要在日志中记录敏感信息

故障排除

端口冲突

如果 8000 端口已被占用：

# 기존 Node.js 프로세스 종료
pkill -f "node"

服务器稳定性

如果服务器意外关闭：

• 考虑使用 PM2 或其他进程管理器
• 查看日志以确定关闭原因

开发指南

日志

• 使用 Pino 日志器实现结构化日志
• 在开发环境中，通过 pino-pretty 输出易于阅读的日志

类型安全

• 使用 TypeScript 和 Zod 保证运行时类型安全性
• 已实现 API 请求/响应的模式验证

CLINE MCP 市场注册指南

准备工作

以上内容已经按照要求翻译成了中文，并保持了 Markdown 格式不变。代码块和链接内容也原样保留。

1. GitHub 仓库必须是公开的
2. README.md 文件中应包含明确的安装和配置方法
3. (可选) 可以通过 llms-install.md 文件提供针对 AI 代理的额外安装指南

注册流程

1. 在 CLINE MCP 市场仓库 创建一个新的 issue。

2. 在 issue 中包括以下信息：

   • GitHub 仓库 URL: https://github.com/techkwon/mcp-gemini
   • Logo 图片: 400×400 大小的 PNG 文件
   • 增加理由: 此 MCP 服务器可以为 CLINE 用户提供的价值
     示例：

   ## MCP Gemini 服务器注册请求
   
   ### GitHub 仓库
   https://github.com/techkwon/mcp-gemini
   
   ### 主要功能
   - 利用 Gemini API 生成文本
   - 生成及编辑图像（使用 gemini-2.0-flash-exp 模型）
   - 分析 YouTube 视频内容
   - 网络搜索功能
   
   ### 用户利益
   - 通过 MCP 协议轻松使用最新的 Gemini 模型
   - 支持处理多种媒体格式（文本、图像、视频）
   - 明确的 JSON-RPC 接口便于集成
   - 提供详细的文档和示例
   

3. CLINE 将测试是否仅凭 README.md 即可成功安装服务器。

审批流程

1. CLINE 团队将审查提交的 MCP 服务器。
2. 进行安全性和稳定性验证。
3. 获得批准后，该服务器将被添加到市场中，所有 CLINE 用户均可访问。

优化安装指南

可以通过创建 llms-install.md 文件来提供针对 AI 代理的额外安装指南：

# MCP Gemini 서버 설치 가이드 (AI 에이전트용)

## 환경 요구사항
- Node.js 18.0.0 이상
- npm 또는 yarn
- Google AI Studio API 키

## 설치 단계
1. 저장소 클론
2. 의존성 설치: `npm install`
3. 환경 변수 설정: GOOGLE_API_KEY 추가
4. 빌드: `npm run build`
5. 서버 실행: `npm run start`

## 설정 검증
- 8000번 포트 사용 가능 여부 확인
- API 키 유효성 검증
- CORS 설정 확인

## 문제 해결
- 포트 충돌 시 해결 방법
- API 키 오류 해결 방법
- 일반적인 설치 문제 해결 가이드