YourImageShare MCP

yourimageshare-mcp

Servidor MCP (Model Context Protocol) para YourImageShare. Permite que um agente de IA compatível com MCP (Claude Desktop, Claude Code e outros clientes MCP) envie, liste e exclua arquivos diretamente no YourImageShare - "envie este screenshot e me dê um link" como uma chamada de ferramenta em vez de um loop manual de copiar-colar-enviar.

• Obtenha uma chave de API: faça login e abra a aba API em yourimageshare.com/my-account.
• Referência HTTP completa: yourimageshare.com/about/api.

Instalação / execução

Não é necessária instalação - execute diretamente com npx:

npx yourimageshare-mcp

Também listado no Smithery, caso seu cliente MCP instale a partir de lá.

Configuração do Claude Desktop / Claude Code

Adicione ao config do seu cliente MCP (ex.: claude_desktop_config.json):

{
  "mcpServers": {
    "yourimageshare": {
      "command": "npx",
      "args": ["-y", "yourimageshare-mcp"],
      "env": {
        "YIS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Variáveis de ambiente

Variável	Obrigatória	Finalidade
YIS_API_KEY	sim	Sua chave de API do YourImageShare.
YIS_BASE_URL	não	Substitui a URL base da API (padrão https://yourimageshare.com/api). Apenas para testes.

Ferramentas

upload_image

Envia um arquivo. Forneça um dos seguintes:

• path - um caminho de arquivo local que este processo do servidor possa ler, ou
• base64 + filename - conteúdo do arquivo inline, para clientes MCP sem acesso ao sistema de arquivos local.

Opcional expiresIn (segundos, de 60 a 2.592.000 = 30 dias) exclui automaticamente o upload posteriormente. Retorna o mesmo formato JSON da resposta de upload da API HTTP (id, type, path, src, direct, expires_at).

list_uploads

Opcional page (padrão 1, 50 por página). Retorna seus uploads do mais recente para o mais antigo.

delete_upload

Exige id (de upload_image/list_uploads). Exclui permanentemente o upload.

Observações

• Este servidor atua apenas como a conta vinculada a YIS_API_KEY - não há como um agente conectado atuar como outra conta.
• Erros da API (chave inválida, limite de taxa, arquivo rejeitado pela moderação, etc.) retornam como resultado de erro da ferramenta com a mensagem da própria API, não como uma chamada de ferramenta que falhou.
• Construído como um cliente pequeno e autônomo, em vez de depender do pacote npm separado yourimageshare, para que os lançamentos deste servidor não fiquem acoplados aos daquele pacote.

Licença

MIT

Suporte

yourimageshare.com/contact