Stock Images MCP Server
A Model Context Protocol (MCP) server for searching and downloading stock images from multiple platforms. Built for personal use with Cursor and shared with the community.
Prerequisites
Before setting up this MCP server, you need to install uv, a fast Python package installer and resolver:
Install uv
macOS/Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh
Windows:
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
Alternative (using pip):
pip install uv
The uvx command used in the MCP configuration requires uv to be installed on your system.
🚀 Quick Setup for Cursor
Step 1: Add to Cursor's MCP Configuration
Add this configuration to your ~/.cursor/mcp.json file:
{
"mcpServers": {
"stock-images-mcp": {
"command": "uvx",
"args": ["git+https://github.com/Zulelee/stock-images-mcp"],
"env": {
"UNSPLASH_API_KEY": "your_unsplash_api_key_here",
"PEXELS_API_KEY": "your_pexels_api_key_here",
"PIXABAY_API_KEY": "your_pixabay_api_key_here"
}
}
}
}
Step 2: Get API Keys (Atleast one of the API keys is required)
Unsplash:
- Go to https://unsplash.com/developers
- Make sure you are logged in
- Create an app
- Get your API key from the app dashboard
Pexels:
- Go to https://www.pexels.com/api/
- Make sure you are logged in
- Click "Your API Key" button
- Copy your API key
Pixabay:
- Go to https://pixabay.com/api/docs/
- Make sure you are logged in
- Find your API key under "Parameters" in the docs
Step 3: Activate the Tool in Cursor Settings
Switch on the toggle for stock-images-mcp in cursor settings
Step 4: Use the Tools
Once the tool connects, you can use the stock images tools directly in your conversations:
- Search for images: "Find tech workspace images"
- Download images: "Download 5 nature photos"
- Search specific platforms: "Search Unsplash for coding setup images"
Available Tools
search_stock_images: Search across Pexels, Unsplash, and Pixabay
Metadata
Release files for iflow-mcp_zulelee-stock-images-mcp 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_zulelee_stock_images_mcp-1.0.0.tar.gz | 3.3 kB | Without provenance | Details for iflow_mcp_zulelee_stock_images_mcp-1.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_zulelee_stock_images_mcp-1.0.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_zulelee_stock_images_mcp-1.0.0-py3-none-any.whl |
Total release size: 7.6 kB
Release files / iflow_mcp_zulelee_stock_images_mcp-1.0.0.tar.gz
| Download URL | iflow_mcp_zulelee_stock_images_mcp-1.0.0.tar.gz |
|---|---|
| Size | 3.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6dbc927a8fdae81605a7b6602d6588b5e327e319400db7e71f8650f30d972730
|
|
BLAKE2b-256 checksum How to use checksums |
3feac6e637a84264ba0fadb264a93f68e73686d6bfbc39f96c7d85f6f678d35d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_zulelee_stock_images_mcp-1.0.0-py3-none-any.whl
| Download URL | iflow_mcp_zulelee_stock_images_mcp-1.0.0-py3-none-any.whl |
|---|---|
| Size | 4.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ec2cfef311e80dea420444978e6824300b471110d36a4f41e1cb2243b0b297e1
|
|
BLAKE2b-256 checksum How to use checksums |
25916059510acbeeadc2b43c9dcdcc21d9f461714dd0e643b4dd534265eb60a8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_zulelee-stock-images-mcp 1.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.