Artin0123-gemini-image-mcp-server

image-mcp-server-gemini

这是一个远程服务。处理本地图片和视频，请使用本地版本。

功能

• 通过一次工具调用分析一个或多个图片 URL。
• 无需将文件下载到本地即可分析 YouTube 视频。
• 提供 API 密钥，并可通过环境变量覆盖 Gemini 模型。
• 文件大小限制：图片大小限制为 16 MB，以确保快速处理。
• YouTube 视频：没有大小限制，因为视频由 Gemini API 直接流式传输。

安装

通过 Smithery 安装

在 Claude Desktop 中安装服务：

npx -y @smithery/cli install @Artin0123/gemini-image-mcp-server --client claude

手动安装

# Clone the repository
git clone https://github.com/Artin0123/gemini-vision-mcp.git
cd gemini-vision-mcp

# Install dependencies
npm install

# Compile TypeScript to dist/
npm run build

配置

在 Google AI Studio 中创建 Gemini API 密钥，并将 GEMINI_API_KEY 提供给服务。

{
  "mcpServers": {
    "gemini-media": {
      "command": "node",
      "args": ["/absolute/path/to/gemini-vision-mcp/dist/index.js"],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here",
        "GEMINI_MODEL": "models/gemini-flash-lite-latest"
      }
    }
  }
}

如果未提供密钥，服务仍可启动（便于自动扫描），但在配置有效的 API 密钥之前，任何工具调用都会返回配置错误。

覆盖模型

服务默认使用 models/gemini-flash-lite-latest。可通过以下任一方式覆盖：

设置 GEMINI_MODEL 环境变量，或在 Smithery/SDK 配置架构中提供 modelName。

可用工具

• analyze_image：分析一个或多个图片 URL。每张图片的最大文件大小：16 MB。
• analyze_youtube_video：根据 URL 分析 YouTube 视频。没有大小限制。

图片 URL 会被下载并处理，大小限制为 16 MB，以确保快速响应。超过此限制的文件会导致错误消息，其中会指出实际文件大小。

YouTube 视频由 Gemini API 直接流式传输，无需下载，因此没有大小限制。

提示词示例

Please analyze this product photo: https://teimg-bgr.pages.dev/file/mvYT6KeF.webp

Extract the main talking points from this clip: https://www.youtube.com/watch?v=dQw4w9WgXcQ

开发

npm install
npm test
npm run build

测试套件会测试 URL 转发、MIME 处理和配置回退。

许可证

MIT