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 the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a 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.网络搜索 最新的 AI 技术趋势

响应格式

所有 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 市场注册指南

准备事项

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 密钥错误解决方法
- 常见安装问题解决指南