unsplash-mcp-server
Overview
The Unsplash MCP Server is a development guide for building a powerful tool for Large Language Model (LLM) applications using the Model Context Protocol (MCP). It facilitates standardized communication between LLM applications and external services.
To use the Unsplash MCP Server, set up your development environment by installing Node.js and npm, create a project directory, and install the MCP TypeScript SDK. Follow the provided instructions to build and run your first MCP server.
- Real-time data provision from databases and APIs. - Exposure of specialized tools for image processing and data analysis. - Management and sharing of prompts for LLM applications. - Integration with external systems and services.
- Building scalable LLM applications that require external data access.
- Creating modular tools for specific tasks like image processing.
- Facilitating collaboration between multiple LLM applications and servers.
Add to your AI client
Use these steps to connect unsplash-mcp-server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"unsplash-mcp-server-mineru98": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-unsplash-mcp-server-mineru98"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"unsplash-mcp-server-mineru98": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-unsplash-mcp-server-mineru98"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"unsplash-mcp-server-mineru98": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-unsplash-mcp-server-mineru98"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"unsplash-mcp-server-mineru98": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-unsplash-mcp-server-mineru98"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"unsplash-mcp-server-mineru98": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-unsplash-mcp-server-mineru98"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"unsplash-mcp-server-mineru98": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-unsplash-mcp-server-mineru98"
]
}
}
}FAQ
What is the Model Context Protocol (MCP)?
MCP is a standardized communication protocol that facilitates interaction between LLM applications and external services.
How do I set up the Unsplash MCP Server?
Follow the development guide to install Node.js, create a project directory, and set up the MCP TypeScript SDK.
Can I customize the transport mechanism?
Yes! MCP supports custom transport implementations for flexible communication.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":3019,"uuid":"814bdc81-61da-4abb-9a67-f25a05c46712","name":"unsplash-mcp-server","title":"unsplash-mcp-server","description":"","avatar_url":"https://avatars.githubusercontent.com/u/15326932?v=4","created_at":"2025-03-17T02:27:45.209Z","updated_at":"2025-03-18T15:06:23.396Z","status":"created","author_name":"Mineru98","author_avatar_url":"https://avatars.githubusercontent.com/u/15326932?v=4","tags":"unsplash,mcp,unsplash-api","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/Mineru98/unsplash-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":"https://camo.githubusercontent.com/39cbc120886daea86c996cbc387842cbc7dc86a06b5452fba8e0de55a6503bcd/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6d6f64656c636f6e7465787470726f746f636f6c2e696f2d6f72616e67652e737667","type":null,"metadata":"{\"star\":\"0\",\"license\":\"MIT license\",\"language\":\"TypeScript\",\"is_official\":false,\"latest_commit_time\":\"2025-03-17 10:12:42\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]