remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides advanced image search capabilities for Unsplash's photo library, allowing filtering by keyword relevance, color schemes, orientation options, with custom sorting and pagination.

Servidor MCP de Unsplash

Inglés | Chino tradicional

Un servidor MCP simple para una integración perfecta de imágenes de Unsplash y capacidades de búsqueda.

📋 Descripción general

El servidor MCP de Unsplash se utiliza para buscar imágenes de alta calidad. Es ideal para desarrolladores que desean integrar la funcionalidad de Unsplash en sus aplicaciones.

✨ Características

Búsqueda avanzada de imágenes : busque en la extensa biblioteca de fotos de Unsplash con filtros para:
- Relevancia de las palabras clave
- Esquemas de color
- Opciones de orientación
- Ordenación y paginación personalizadas

🔑 Obtener la clave de acceso de Unsplash

Antes de instalar este servidor, necesitará obtener una clave de acceso a la API de Unsplash:

Crea una cuenta de desarrollador en Unsplash
Registrar una nueva aplicación
Obtén tu clave de acceso desde la página de detalles de la aplicación
Utilice esta clave en los pasos de configuración a continuación

Para obtener más detalles, consulte la documentación oficial de la API de Unsplash .

🚀 Instalación

Para instalar Unsplash Image Integration Server para Claude Desktop automáticamente a través de Smithery :

Configuración de IDE

IDE de cursor

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-****-****

Instalación manual

# 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 .

Integración del editor de cursores

Agregue la siguiente configuración al archivo settings.json de su editor de Cursor:

⚠️ Nota: ajuste la siguiente configuración según su instalación real:

Si uv no está en la ruta de su sistema, utilice una ruta absoluta (por ejemplo, /path/to/uv )
./server.py debe modificarse a la ubicación actual del script del servidor (puede usar la ruta absoluta o la ruta relativa al espacio de trabajo)

{
  "mcpServers": {
    "unsplash": {
      "command": "uv",
      "args": ["run", "--with", "fastmcp", "fastmcp", "run", "./server.py"],
      "env": {
        "UNSPLASH_ACCESS_KEY": "${YOUR_ACCESS_KEY}"
      }
    }
  }
}

Uso en el cursor

🛠️ Herramientas disponibles

Buscar fotos

{
  "tool": "search_photos",
  "query": "mountain",
  "per_page": 5,
  "orientation": "landscape"
}

🔄 Otras implementaciones

Golang: unsplash-mcp-server
Java: unsplash-mcp-server

📄 Licencia

Licencia MIT

📬 Contacto

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

search_photos

Un servidor liviano que permite una integración perfecta con la biblioteca de imágenes de Unsplash, lo que permite a los desarrolladores buscar fotos de alta calidad con varios filtros directamente desde el editor del Cursor.

Related Resources

Reddit Discussion about this server

Unsplash MCP Server