GunsNPrices

Servidor MCP GunsNPrices

Um servidor MCP que ajuda assistentes de IA com perguntas sobre compras de armas e munições. Ele lê títulos de produtos de armas de fogo e munições (marca, modelo, calibre, capacidade do carregador, comprimento do cano, munições por caixa), calcula o custo por munição e aponta para as páginas do GunsNPrices que comparam preços atuais em mais de 40 lojas de armas e munições nos EUA.

Ele roda localmente e não precisa de chave de API: tudo vem do parser de código aberto gunsnprices e de um snapshot dos links das páginas do GunsNPrices. Ele não busca preços ao vivo; para perguntas do tipo "onde é mais barato", o assistente obtém as páginas do GunsNPrices para enviar a você.

Ferramentas

Ferramenta	O que faz
parse_product_title	Título → arma de fogo ou munição, marca, modelo, calibres, capacidade do carregador, comprimento do cano, munições por caixa, custo por munição, páginas de comparação de preços
identify_firearm_model	Título ou descrição → marca, família de modelos, modelo exato (50 marcas); decodifica números de peça da Glock
lookup_caliber	9mm Luger, 300 BLK, 12ga, 6.5 CM → nome padrão do calibre, tipo e sua página de preços de munição
cost_per_round	Preço + quantidade de munições (ou um título para ler essas informações) → custo por munição
find_price_comparison_pages	Modelo, marca ou calibre → páginas do GunsNPrices comparando preços atuais, do mais específico ao mais geral
list_supported	As 50 marcas com reconhecimento de modelo, ou os 293 calibres conhecidos

Todas as ferramentas são somente leitura e funcionam offline.

Instalação

O servidor é o pacote npm gunsnprices-mcp e roda com Node.js 18 ou mais recente.

Claude Code

claude mcp add gunsnprices -- npx -y gunsnprices-mcp

Claude Desktop: adicione ao claude_desktop_config.json (Configurações → Desenvolvedor → Editar Config):

{
  "mcpServers": {
    "gunsnprices": {
      "command": "npx",
      "args": ["-y", "gunsnprices-mcp"]
    }
  }
}

Cursor: o mesmo bloco no ~/.cursor/mcp.json.

VS Code: .vscode/mcp.json:

{
  "servers": {
    "gunsnprices": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "gunsnprices-mcp"]
    }
  }
}

Claude Desktop, com um clique: baixe o gunsnprices-mcp-<version>.mcpb do último lançamento e abra-o (MCP Bundle, Node.js incluído com o Claude Desktop).

Docker:

docker build -t gunsnprices-mcp https://github.com/gunsnprices/gunsnprices-mcp.git

{
  "mcpServers": {
    "gunsnprices": { "command": "docker", "args": ["run", "-i", "--rm", "gunsnprices-mcp"] }
  }
}

Coisas para perguntar

• "O que exatamente é um G19 GEN5 9MM 4.02 15RD FS MOS, e onde posso comparar preços?"
• "Qual dessas listagens de 9mm é a mais barata por munição: $18,99 por 50, $289 por 1.000, $13,49 por 20?"
• "300 BLK é o mesmo que .300 AAC Blackout? Onde comparo preços de munição para isso?"
• "Limpe esta planilha de títulos de armas em marca, modelo, calibre e comprimento do cano."

Exemplo de resultado de find_price_comparison_pages para "Glock 19":

{
  "query": "Glock 19",
  "model": { "brand": "Glock", "family": "Glock 19", "model": "Glock 19", "generation": "", "configs": [], "features": [], "source": "title" },
  "gunsnprices_pages": [
    { "kind": "model", "name": "Glock 19", "url": "https://gunsnprices.com/guns/glock-19" },
    { "kind": "brand", "name": "All Glock models", "url": "https://gunsnprices.com/glock-models" },
    { "kind": "search", "name": "GunsNPrices search: Glock 19", "url": "https://gunsnprices.com/en-search/?search=Glock%2019" }
  ]
}

Precisão

O parsing é feito pela biblioteca gunsnprices. Em 63.755 listagens de mais de 40 lojas, ela reconhece o mesmo modelo que gunsnprices.com em 99,97% dos casos em que o site conhece o modelo, e acerta o calibre em 97,8% dos títulos de armas de fogo e 94,9% dos títulos de munições em que encontra um. Os detalhes estão no README da biblioteca.

Relacionados

• Biblioteca de parsing: npm, PyPI
• Conjuntos de dados abertos de calibres e modelos: Hugging Face, GitHub, Kaggle

Licença

O código está sob a Licença MIT. Os links de páginas em src/data/ vêm do conjunto de dados firearm-models do GunsNPrices e estão sob CC BY 4.0: credite GunsNPrices (gunsnprices.com) com um link.

Perguntas e correções: abra uma issue ou escreva para app@gunsnprices.com.