Artin0123-gemini-image-mcp-server
Analyze images and videos with Gemini to get fast, reliable visual insights. Handle content from U鈥�
可用工具 （5 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
tavily_search 14 个参数 需填 1 项
Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs.
必填参数：query
tavily_extract 6 个参数 需填 1 项
Extract content from URLs. Returns raw page content in markdown or text format.
必填参数：urls
tavily_crawl 11 个参数 需填 1 项
Crawl a website starting from a URL. Extracts content from pages with configurable depth and breadth.
必填参数：url
tavily_map 8 个参数 需填 1 项
Map a website's structure. Returns a list of URLs found starting from the base URL.
必填参数：url
tavily_research 2 个参数 需填 1 项
Perform comprehensive research on a given topic or question. Use this tool when you need to gather information from multiple sources to answer a question or complete a task. Returns a detailed response based on the research findings.
必填参数：input
服务介绍
image-mcp-server-gemini
This is remote server, use local version for local images and videos.
# Features
- Analyze one or more image URLs with a single tool call.
- Analyze YouTube videos without downloading files locally.
- Supply an API key and optionally override the Gemini model via environment variables.
- File size limit: Images are limited to 16 MB to ensure fast processing.
- YouTube videos: No size limit as they are streamed directly by Gemini API.
# Installation
# # Installing via Smithery
Install the server in Claude Desktop:
npx -y @smithery/cli install @Artin0123/gemini-image-mcp-server - -client claude
# # Manual Installation
# 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
# Configuration
Create a Gemini API key in Google AI Studio and provide GEMINI_API_KEY to the server.
{
"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"
}
}
}
}
If no key is supplied, the server can still start (handy for automated scans), but any tool invocation will return a configuration error until a valid API key is configured.
# # Model override
The server defaults to models/gemini-flash-lite-latest. Override it by either:
Setting the
GEMINI_MODELenvironment variable, or ProvidingmodelNamein the Smithery/SDK configuration schema.
# Available tools
analyze_image: Analyze one or more image URLs. Maximum file size: 16 MB per image.analyze_youtube_video: Analyze a YouTube video from URL. No size limit.
Image URLs are downloaded and processed with a 16 MB size limit to ensure fast response times. Files exceeding this limit will result in an error message indicating the actual file size.
YouTube videos are streamed directly by Gemini API without downloading, so there is no size restriction.
# # Prompt examples
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
# Development
npm install
npm test
npm run build
The test suite exercises URL forwarding, MIME handling, and configuration fallbacks.
# License
MIT
