convez.ai
MCP ServerIntegração & APIsIntermediário
mmarquezs

Warracker MCP Server

mmarquezs/warracker-mcp

Integre gestão de garantias com agentes de IA via MCP

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que integra o Warracker, plataforma de rastreamento de garantias, com agentes de IA. Permite criar, atualizar, consultar garantias e gerenciar tags programaticamente via Claude e outras ferramentas que suportam MCP.

Instalação

$npx convez-ai mmarquezs/warracker-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
v0.1.2
Issues abertas
0
Contribuidores
1

Casos de uso

  • Automatizar registro e atualização de garantias de produtos
  • Consultar historicamente garantias com processamento de linguagem natural
  • Anexar documentos (notas fiscais, manuais) a garantias via agentes

Veredito

Server MCP bem estruturado para conectar o Warracker com agentes de IA. Oferece operações CRUD completas e upload de arquivos, mas requer instância Warracker própria e é mais adequado para contextos corporativos ou de produto específico.

README

A tradução para o português deste README ainda está na fila.

Warracker MCP Server

MCP server for Warracker warranty management. Enables AI agents to create, update, query warranties, upload files, and manage tags programmatically.

Built with FastMCP, runs as a stdio subprocess — no HTTP server, no Docker.

Installation

pip install warracker-mcp

Or install directly from GitHub (pin to a tag):

pip install warracker-mcp@git+https://github.com/mmarquezs/warracker-mcp@v0.1.0

Configuration

Set these environment variables:

VariableDescriptionExample
WARRACKER_URLBase URL of your Warracker instancehttp://10.0.0.143:80
WARRACKER_USERNAMEUsername for authenticationadmin
WARRACKER_PASSWORDPassword for authenticationyour-password

MCP Client Configuration

Add to your MCP client config (e.g. Claude Desktop, opencode, Cursor):

{
  "mcpServers": {
    "warracker": {
      "command": "warracker-mcp",
      "env": {
        "WARRACKER_URL": "http://10.0.0.143:80",
        "WARRACKER_USERNAME": "your-username",
        "WARRACKER_PASSWORD": "your-password"
      }
    }
  }
}

Or with uvx:

{
  "mcpServers": {
    "warracker": {
      "command": "uvx",
      "args": ["warracker-mcp"],
      "env": {
        "WARRACKER_URL": "http://10.0.0.143:80",
        "WARRACKER_USERNAME": "your-username",
        "WARRACKER_PASSWORD": "your-password"
      }
    }
  }
}

Tools

ToolDescription
warranty_createCreate a warranty with all fields + optional file attachment
warranty_updateUpdate warranty fields by ID, with optional file attachment
warranty_getGet a single warranty by ID
warranties_listList/search warranties with optional filtering and pagination
tags_listList all existing tags
tag_createCreate a new tag with name and optional color
currencies_listList all supported currencies
warranty_upload_fileUpload a file to an existing warranty (base64 content or URL)

Warranty Duration

When creating or updating a warranty, provide exactly one of:

  • warranty_duration_years — duration in years
  • warranty_duration_months — duration in months
  • warranty_duration_days — duration in days
  • exact_expiration_date — exact date (YYYY-MM-DD)
  • is_lifetime — set to true for lifetime warranty

File Uploads

Files can be attached during creation/update via file_content_b64, file_name, and file_type parameters, or uploaded separately using warranty_upload_file which accepts either base64-encoded content or a URL to download from.

Supported file types:

  • invoice, manual, other_document: PDF, PNG, JPG, JPEG, ZIP, RAR, WEBP, GIF
  • product_photo: PNG, JPG, JPEG, WEBP, GIF

Development

git clone https://github.com/mmarquezs/warracker-mcp
cd warracker-mcp
python -m venv .venv
source .venv/bin/activate
pip install -e .

Run the server:

WARRACKER_URL=http://localhost:80 WARRACKER_USERNAME=admin WARRACKER_PASSWORD=pass warracker-mcp

License

MIT

Ver o original no GitHub

Bom para

Relacionados