Skip to main content
Glama
enesjakozh

MCP Gemini API Server

by techkwon
GitHub
TypeScript
2
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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 密钥错误
    • 确保您的 API 密钥在config.ts文件中设置正确。
    • 检查 Gemini API 配额和权限
  3. 内存使用问题
    • 检查ecosystem.config.js中的内存限制设置
    • 使用 PM2 监控跟踪内存使用情况

贡献

  1. 分叉项目
  2. 创建你的功能分支（ git checkout -b feature/AmazingFeature ）
  3. 提交您的更改（ git commit -m 'Add some AmazingFeature' ）
  4. 推送到分支（ git push origin feature/AmazingFeature ）
  5. 打开拉取请求

执照

该项目遵循 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 支持）
  • 打字稿：^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 logger 实现结构化日志记录
  • 在开发环境中，通过 pino-pretty 输出可读的日志。

类型安全

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

CLINE MCP 市场注册指南

前期准备

  1. 您的 GitHub 存储库必须是公开的
  2. README.md 文件应包含清晰的安装和设置说明。
  3. （可选）您可以通过llms-install.md文件为您的 AI 代理提供额外的安装说明。

注册程序

  1. 在CLINE MCP Marketplace 存储库中创建新问题
  2. 该问题包含以下信息：
    • GitHub 仓库网址： https://github.com/techkwon/mcp-gemini
    • 徽标图像： PNG文件，尺寸为400×400
    • **附加原因：**此 MCP 服务器可以为 CLINE 用户提供的价值示例：GXP12
  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 키 오류 해결 방법 - 일반적인 설치 문제 해결 가이드

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

通过 MCP 协议提供对 Google Gemini AI 功能（包括文本生成、图像分析、YouTube 视频分析和网络搜索功能）的访问的服务器。

  1. 主要特点
    1. 开始
      1. 基本要求
      2. 安装
      3. 偏好设置
      4. 构建并运行
      5. PM2 服务器管理
    2. Cursor/Claude 集成
      1. MCP 设置
      2. API 端点
    3. 重大更新
      1. 最新版本（2024-03）
      2. 先前版本
    4. 故障排除
      1. 常见问题
    5. 贡献
      1. 执照
        1. 接触
          1. 关键依赖关系
            1. Claude 桌面应用程序集成指南
              1. 设置文件位置
              2. JSON 设置示例
              3. 变量描述
              4. 如何使用
              5. 响应格式
              6. 错误响应
            2. 错误处理
              1. 安全注意事项
                1. 故障排除
                  1. 端口冲突
                  2. 服务器稳定性
                2. 开发指南
                  1. 日志记录
                  2. 类型安全
                3. CLINE MCP 市场注册指南
                  1. 前期准备
                  2. 注册程序
                  3. 审批流程
                  4. 优化安装指南

                Related MCP Servers

                • Gemini MCP Server

                  aliargun
                  -
                  security
                  A
                  license
                  -
                  quality
                  Model Context Protocol (MCP) server implementation that enables Claude Desktop to interact with Google's Gemini AI models.
                  Last updated -
                  53
                  TypeScript
                  MIT License
                  • Apple
                  • Linux

                • Gemini MCP Server

                  palolxx
                  -
                  security
                  -
                  license
                  -
                  quality
                  An MCP server implementation that allows using Google's Gemini AI models (specifically Gemini 1.5 Pro) through Claude or other MCP clients via the Model Context Protocol.
                  Last updated -
                  1
                  JavaScript

                • MCP Gemini Server

                  bsmi021
                  A
                  security
                  A
                  license
                  A
                  quality
                  A dedicated server that wraps Google's Gemini AI models in a Model Context Protocol (MCP) interface, allowing other LLMs and MCP-compatible systems to access Gemini's capabilities like content generation, function calling, chat, and file handling through standardized tools.
                  Last updated -
                  16
                  20
                  TypeScript
                  MIT License
                  • Linux
                  • Apple

                View all related MCP servers

                Appeared in Searches

                New MCP Servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/techkwon/mcp-gemini'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server