YourImageShare MCP

yourimageshare-mcp

Servidor MCP (Model Context Protocol) para YourImageShare. Construído para agentes de codificação com IA (Claude Code, Cursor e outras ferramentas compatíveis com MCP) - cole uma captura de tela em um relatório de bug, uma descrição de PR ou um tópico de suporte como uma URL real em vez de um blob base64 ou uma etapa de upload manual. Funciona da mesma forma com Claude Desktop e qualquer outro cliente MCP.

• 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.
• Especificação OpenAPI 3.1: yourimageshare.com/openapi.json, se suas ferramentas preferirem isso a este README.

Instalar / executar

Não é necessário instalar - execute diretamente com npx:

npx yourimageshare-mcp

Também listado no Smithery, se o seu cliente MCP instalar a partir daí.

Configuração do Claude Desktop / Claude Code

Adicione à configuração 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

Envie um arquivo. Forneça um dos seguintes:

• path - um caminho de arquivo local que este processo de 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

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

Notas

• Este servidor atua apenas como a conta vinculada a YIS_API_KEY - não há como um agente conectado atuar como qualquer outra conta.
• Erros da API (chave inválida, limite de taxa, arquivo rejeitado pela moderação, etc.) retornam como um resultado de erro da ferramenta com a mensagem da própria API, não 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