jeanpfs/stock-images-mcp

MCP server to search and download stock images from Pexels, Unsplash, and Pixabay

Before you install: a copy-paste command is available · license MIT · link reachable

SECURITY.md ✓

View on GitHub ↗Link checked 2026-11-12 · HTTP 200 · opens the vendor's own site

checked 2026-11-14 — requires Node >=22 (LTS since Oct 2024); a note, not a failure.

Install & config

Copy the command above
Paste it as one entry under mcpServers in claude_desktop_config.json — local servers take command + args (example: clients)
Restart your client

Client config (built from the install command this repo gives)

{
  "mcpServers": {
    "jeanpfs-stock-images-mcp": {
      "command": "npx",
      "args": ["-y", "stock-images-mcp"]
    }
  }
}

Parsed from the README we fetched on 2026-10-26; we have not executed it.

command/args come from the install command the repository states. When it is ambiguous, the project README wins.

VS Code (.vscode/mcp.json - the key is servers)

{
  "servers": {
    "jeanpfs-stock-images-mcp": {
      "command": "npx",
      "args": ["-y", "stock-images-mcp"]
    }
  }
}

Same server, but VS Code keeps it under <code>servers</code>.

Claude Code (command line)

claude mcp add --transport stdio jeanpfs-stock-images-mcp -- npx -y stock-images-mcp

Claude Code does not read a config file; add the server with this command.

Key names differ by client: Clients & CLI

Star count: 6 ★ · jeanpfs/stock-images-mcp · read from the GitHub search API · (checked 2026-11-13 20:00:50)
Source: collected from the punkpeye/awesome-mcp-servers list · type: MCP server
Harvest history: first seen 2026-10-23 · last seen 2026-11-14 · seen 26× · listed by 23 sources
Score: score 2,300 · 6 ★ · 23 sources · mcp
Install: npx -y stock-images-mcp

FAQ (answers come from our records)

How do I install it?

The repository provides this install command: npx -y stock-images-mcp. It comes from the repository itself; we cannot guarantee it runs as-is in your client.

Who is it for?

We filed it under these tags: MCP 服务. The tags come from the entry itself, not a taxonomy we imposed.

Who maintains it?

repository jeanpfs/stock-images-mcp；first catalogued 2026-10-23；last seen 2026-11-14。There is no official certification or quality rating here — we record sources and dates only.

# Stock Images MCP

以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →

An MCP (Model Context Protocol) server for searching and downloading stock images from Pexels, Unsplash, and Pixabay.
## Features
searchimages: search one or all configured providers; partial failures are reported per provider
downloadimage: download an image safely into a local folder
## Setup
### Get API keys (at least one required)
| Provider | Env var | Get a key |
| Pexels | PEXELSAPIKEY | https://www.pexels.com/api/ |
| Unsplash | UNSPLASHAPIKEY | https://unsplash.com/developers |
| Pixabay | PIXABAYAPIKEY | https://pixabay.com/api/docs/ |
Optional: STOCKIMAGESDOWNLOADDIR — where downloadimage writes files (default ./downloads).
### Claude Code / Cursor / Claude Desktop
Add to your MCP config (~/.claude/mcp.json, ~/.cursor/mcp.json, or claudedesktopconfig.json):
json
"mcpServers": {
"stock-images": {
"command": "npx",
"args": ["-y", "stock-images-mcp"],
"env": {
"PEXELSAPIKEY": "your-key-here",
"UNSPLASHAPIKEY": "your-key-here",
"PIXABAYAPIKEY": "your-key-here"
Requires Node.js 22+.
### Docker
bash
docker build -t stock-images-mcp .
docker run -i --rm -e PEXELSAPIKEY=xxx -v "$PWD/downloads:/downloads" stock-images-mcp
### From source
bash
git clone https://github.com/jeanpfs/stock-images-mcp.git
cd stock-images-mcp
npm ci && npm run build
PEXELSAPIKEY=xxx node dist/index.js
## Tools
### searchimages
Search for stock images across configured providers.
Parameters:
query (required): search term
provider: "pexels", "unsplash", "pixabay", or "all" (default: "all")
count: results per provider (default 5, max 20)
orientation: "landscape", "portrait", or "square"
Each result has id, provider, url, thumbnail, description, author, authorUrl, downloadUrl, width, height. Pass downloadUrl to downloadimage.
### downloadimage
Download an image into the download directory.
Parameters:
url (required): https image URL on pexels.com, unsplash.com or pixabay.com (use downloadUrl from searchimages)
filename: output name — letters, digits, , -, . only; the extension is added from the content-type if missing (auto-generated if omitted)
folder: subfolder inside the download directory
Behavior and limits:
Download directory is ./downloads, or STOCKIMAGESDOWNLOADDIR if set. Paths that escape it (including via symlinks) are rejected.
Only image/ responses are saved; max 50 MiB; 30 s timeout; redirects are followed only to allowed hosts.
Existing files are never overwritten.
Unsplash downloads require UNSPLASHAPIKEY: the tool calls Unsplash's download endpoint, as their API guidelines require.

Listed badge (optional)

Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.

[![Listed on Anclum](https://anclum.com/badge/listed.svg)](https://anclum.com/en/s/jeanpfs-stock-images-mcp/)

Source: awesome · https://github.com/jeanpfs/stock-images-mcp
Browse by field: MCP servers
Traction: 6 ★
Listed by: 23 independent sources
added: today
Security policy: the repository has SECURITY.md at its root (we checked that the file exists, not what it says)

More like this

glenngillen/mcpmcp-serverMCP server WayStation-ai/mcpMCP server kimtth/mcp-aoai-web-browsingMCP server sxhxliang/mcp-access-pointMCP server

All 6,229 →

Filed under

MCP servers6,229 entries MCP server6,545 Curated list pick6,618

Every tag opens the full list for that filter. Counts are the live catalogue figures.

Browse all fields →

← Back to index