🔎 A MCP server for Unsplash image search.
English | 简体中文
A simple MCP server for seamless Unsplash image integration and search capabilities.
Unsplash MCP Server is used for searching rich, high-quality images. It's ideal for developers who want to integrate Unsplash functionality into their own applications.
Before installing this server, you'll need to obtain an Unsplash API Access Key:
For more details, refer to the official Unsplash API documentation.
To install Unsplash Image Integration Server for Claude Desktop automatically via Smithery:
Cursor IDE
npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cursor --key 7558c683-****-****
Windsurf
npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client windsurf --key 7558c683-****-****
Cline
npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cline --key 7558c683-****-****
# Clone the repository
git clone https://github.com/hellokaton/unsplash-mcp-server.git
# Navigate to project directory
cd unsplash-mcp-server
# Create virtual environment
uv venv
# Install dependencies
uv pip install .
Cursor Editor Integration
Add the following configuration to your Cursor editor's settings.json:
⚠️ Note: Please adjust the following configuration according to your actual installation:
uv is not in your system PATH, use an absolute path (e.g., /path/to/uv)./server.py should be modified to the actual location of your server script (can use absolute path or path relative to workspace)
{
"mcpServers": {
"unsplash": {
"command": "uv",
"args": ["run", "--with", "fastmcp", "fastmcp", "run", "./server.py"],
"env": {
"UNSPLASH_ACCESS_KEY": "${YOUR_ACCESS_KEY}"
}
}
}
}
{
"tool": "search_photos",
"query": "mountain",
"per_page": 5,
"orientation": "landscape"
}