Wikipedia MCP Image Crawler

by dazeb

401 downloads
Not rated
GitHub

About

A Wikipedia Image Search Tool. Follows Creative Commons Licences for images and uses them in your projects via Claude Desktop/Cline.

Details

Author
dazeb
Downloads
401
Categories
Media

- Two tools: wiki_image_search and wiki_image_info
- Search images with customizable result limits (1–50)
- Returns image URLs, dimensions, MIME types, and sizes
- Fetches comprehensive metadata including license and author
- Returns full resolution URLs and description links

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Wikipedia MCP Image Crawler
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install Node.js 18 or higher, clone the repository, install dependencies with pnpm install, and build with pnpm run build. Then configure the server in Claude Desktop or VS Code extensions by adding the path to the built index.js to the MCP servers JSON config. Once set up, invoke the tools wiki_image_search (search by query with optional limit) and wiki_image_info (get metadata for a specific image title).

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "wikipedia mcp image crawler": {
            "wikipedia-mcp-server": {
                "command": "node",
                "args": [
                    "/absolute/path/to/wikipedia-mcp-image-crawler/build/index.js"
                ]
            }
        }
    }
}

McpServers

{
    "wikipedia-mcp-server": {
        "command": "node",
        "args": [
            "/absolute/path/to/wikipedia-mcp-image-crawler/build/index.js"
        ]
    }
}

Wikipedia MCP Image Crawler

A Model Context Protocol (MCP) server for searching and retrieving images from Wikipedia Commons. This server provides tools to search for images and fetch detailed metadata through the Wikipedia API.

I created this tool because i needed images of Greek philosopher's. I needed to mak sure i had full attribution and licenses. This will search wikipedia only and download images that are in the public domain and free to use.

Features

Tools

- wiki_image_search - Search for images on Wikipedia Commons - Search by query with customizable result limits (1-50) - Returns image URLs, dimensions, MIME types, and sizes - wiki_image_info - Get detailed information about specific images - Fetches comprehensive metadata including license and author - Returns full resolution URLs and description links

Installation

Prerequisites

- Node.js 18 or higher - npm or pnpm package manager

Local Installation

1. Clone the repository:
   git clone https://github.com/dazeb/wikipedia-mcp-image-crawler.git
   cd wikipedia-mcp-image-crawler
   

2. Install dependencies:

   pnpm install

3. Build the server:

   pnpm run build

Integration with Claude

Claude Desktop App

Add the server configuration to your Claude config file:

MacOS:

nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

Linux:

nano ~/.config/Claude/claude_desktop_config.json

Windows:

notepad %APPDATA%\Claude\claude_desktop_config.json

Add this configuration (adjust the path to where you cloned the repository):

{
"mcpServers": {
"wikipedia-mcp-server": {
"command": "node",
"args": ["/absolute/path/to/wikipedia-mcp-image-crawler/build/index.js"],
"disabled": false,
"autoApprove": []
}
}
}

VSCode Extensions

Cline VSCode Extension

For the Cline VSCode extension, add to:

MacOS:

~/Library/Application\ Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

Linux:

~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

Windows:

%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

For VS Code Insiders, replace Code with Code - Insiders in the paths above.

Add this configuration to the JSON file:

{
"mcpServers": {
"wikipedia-mcp-server": {
"command": "node",
"args": ["/absolute/path/to/wikipedia-mcp-image-crawler/build/index.js"],
"disabled": false,
"autoApprove": []
}
}
}

If the file already contains other MCP servers, add this entry to the existing mcpServers object.

Usage

Once installed, the server provides two main tools:

Image Search

Search for images matching a query:
{
  "name": "wiki_image_search",
  "arguments": {
    "query": "golden gate bridge",
    "limit": 5
  }
}

Image Information

Get detailed metadata for a specific image:
{
  "name": "wiki_image_info",
  "arguments": {
    "title": "File:Golden Gate Bridge.jpg"
  }
}

Development

Running in Watch Mode

For development with auto-rebuild:
pnpm run watch

Debugging

Since MCP servers communicate over stdio, use the MCP Inspector for debugging:
pnpm run inspector

This will provide a URL to access the debugging interface in your browser.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.