Unsplash MCP Server

Busca e integra imágenes de Unsplash usando su API oficial.

GitHub

235

Prueba este MCPPatrocinado

Documentación

Servidor MCP de Unsplash

Inglés | 简体中文

Un servidor MCP simple para la integración y búsqueda de imágenes de Unsplash sin interrupciones.

📋 Descripción general

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

✨ Características

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

🔑 Obtención de la clave de acceso de Unsplash

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

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

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

🚀 Instalación

Para instalar el Servidor de Integración de Imágenes de Unsplash para Claude Desktop automáticamente a través de Smithery:

Configuración en IDE

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

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 con el editor Cursor

Agrega la siguiente configuración al settings.json de tu editor Cursor:

⚠️ Nota: Ajusta la siguiente configuración según tu instalación real:

Si uv no está en la ruta PATH de tu sistema, usa una ruta absoluta (por ejemplo, /path/to/uv)
./server.py debe modificarse a la ubicación real de tu script del servidor (puede usar una ruta absoluta o una 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 Cursor

🛠️ Herramientas disponibles

Buscar fotos

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