Unsplash MCP Server

Pesquise e integre imagens do Unsplash usando sua API oficial.

GitHub

235

Experimente este MCPPatrocinado

Documentação

Servidor MCP do Unsplash

English | 简体中文

Um servidor MCP simples para integração e busca de imagens do Unsplash de forma contínua.

📋 Visão Geral

O Servidor MCP do Unsplash é usado para buscar imagens ricas e de alta qualidade. É ideal para desenvolvedores que desejam integrar a funcionalidade do Unsplash em seus próprios aplicativos.

✨ Recursos

Busca Avançada de Imagens: Pesquise a extensa biblioteca de fotos do Unsplash com filtros para:
- Relevância de palavras-chave
- Esquemas de cores
- Opções de orientação
- Ordenação personalizada e paginação

🔑 Obtendo a Chave de Acesso do Unsplash

Antes de instalar este servidor, você precisará obter uma Chave de Acesso da API do Unsplash:

Crie uma conta de desenvolvedor em Unsplash
Registre um novo aplicativo
Obtenha sua Chave de Acesso na página de detalhes do aplicativo
Use esta chave nas etapas de configuração abaixo

Para mais detalhes, consulte a documentação oficial da API do Unsplash.

🚀 Instalação

Para instalar o Servidor de Integração de Imagens do Unsplash para o Claude Desktop automaticamente via Smithery:

Configuração na 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-****-****

Instalação 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 .

Integração com o Editor Cursor

Adicione a seguinte configuração ao settings.json do seu editor Cursor:

⚠️ Nota: Ajuste a seguinte configuração de acordo com sua instalação real:

Se uv não estiver no PATH do seu sistema, use um caminho absoluto (por exemplo, /path/to/uv)
./server.py deve ser modificado para o local real do seu script de servidor (pode usar caminho absoluto ou caminho relativo ao espaço de trabalho)

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

Usando no Cursor

🛠️ Ferramentas Disponíveis

Buscar Fotos

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