# 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:
   ```bash
   git clone https://github.com/dazeb/wikipedia-mcp-image-crawler.git
   cd wikipedia-mcp-image-crawler
   ```

2. Install dependencies:
   ```bash
   pnpm install
   ```

3. Build the server:
   ```bash
   pnpm run build
   ```

### Integration with Claude

#### Claude Desktop App

Add the server configuration to your Claude config file:

**MacOS**:
```bash
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
```

**Linux**:
```bash
nano ~/.config/Claude/claude_desktop_config.json
```

**Windows**:
```bash
notepad %APPDATA%\Claude\claude_desktop_config.json
```

Add this configuration (adjust the path to where you cloned the repository):
```json
{
  "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**:
```bash
~/Library/Application\ Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
```

**Linux**:
```bash
~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
```

**Windows**:
```bash
%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:
```json
{
  "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:
```json
{
  "name": "wiki_image_search",
  "arguments": {
    "query": "golden gate bridge",
    "limit": 5
  }
}
```

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

## Development

### Running in Watch Mode
For development with auto-rebuild:
```bash
pnpm run watch
```

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

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