luccasparoni/url-fetch-mcp

URL Image Fetcher MCP Server

This project provides a simple MCP (Multi-part Content Protocol) server that exposes a single tool, get_image_from_url. This tool fetches an image from a given URL and returns it to the Gemini CLI.

Setup

1. Create a virtual environment:

   python3 -m venv mcp-venv
   

2. Activate the virtual environment:

   source mcp-venv/bin/activate
   

3. Install the dependencies:

   pip install -r requirements.txt
   

Running the Server

With the virtual environment activated, you can start the server with the following command:

python image_fetcher_final.py

The server will start on http://localhost:8000.

Gemini CLI Configuration

To allow the Gemini CLI to communicate with this server, you must update your Gemini settings.

1. Open the settings file located at ~/.gemini/settings.json.

2. Add the following configuration to the mcpServers object:

   "mcpServers": {
     "image_fetcher": {
       "httpUrl": "http://localhost:8000/mcp"
     }
   }
   

   If you already have other servers configured, just add the image_fetcher entry to the existing mcpServers object.