Skip to main content
Glama
GeminiMcpServer
by bowwowxx

GeminiMcpServer

GeminiMcpServer 是一個 Model Context Protocol (MCP) 伺服器,可將 LM Studio(或其他支援 MCP 的客戶端)與 Google Gemini API 無縫連接,用於影像生成與多模態任務處理。

mole


✨ 功能特色

  • 🔗 完整 MCP 支援 – 與 LM Studio 等 MCP 客戶端即時整合。

  • 🎨 影像生成 – 使用 Google Gemini 2 模型產生圖片。

  • 🖼 多模態輸入 – (選用)同時處理文字與圖片輸入。

  • ⚡ 本地與雲端混合流程 – 本地執行 LM Studio,同時利用 Gemini API 提供的雲端運算能力。


Related MCP server: Nano Banana MCP

📦 系統需求


🚀 安裝與設定

git clone git@github.com:bowwowxx/GeminiMcpServer.git
cd GeminiMcpServer
npm install

建立 Google API Key:

  1. 前往 Google AI Studio

  2. 建立新的 API 金鑰

設定環境變數: 在專案根目錄建立 .env 檔,並加入:

GEMINI_API_KEY="your_api_key_here"

▶ 使用方式

啟動伺服器:

npm start

執行測試:

npx tsx testapi.js

此測試會使用 Gemini 2 的實驗性影像生成 API 建立圖片。

mole


📡 MCP 請求範例

{
  "tool": "generateImage",
  "params": {
    "prompt": "A photorealistic 3D rendered pig standing in a sunny field",
    "outputFormat": "png",
    "aspectRatio": "16:9"
  }
}

📡 LM Studio設定範例

{
  "mcpServers": {
    "GeminiMcpServer": {
      "command": "npm",
      "args": [
        "run",
        "start"
      ],
      "cwd": "/Users/bowwow/github/GeminiMcpServer"
    }
  }
}

mole

Available Tools

1 tool
generateImageD

Inputs: prompt (required), aspectRatio, outputFormat.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    D1.7/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of ambiguity or overlap between tools. The single tool stands alone with a distinct purpose by default.

    Naming Consistency5/5

    A single tool inherently has perfect naming consistency, as there are no other tools to compare it against. The name 'generateImage' follows a clear verb_noun pattern.

    Tool Count2/5

    One tool is too few for most server purposes, as it limits functionality and suggests an incomplete or trivial implementation. For an image generation server, more tools (e.g., for editing, listing, or managing images) would typically be expected.

    Completeness1/5

    The server is severely incomplete for image generation, lacking any tools for operations like editing images, retrieving generated images, managing parameters, or handling errors. A single generation tool leaves significant gaps in the workflow.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    Appeared in Searches