Gunsnation MCP

Gunsnation MCP Server

O Gunsnation MCP Server é uma camada de integração leve que expõe o catálogo de armas de fogo da Gunsnation para assistentes de IA através do Model Context Protocol (MCP). Ele permite que clientes de IA compatíveis pesquisem, filtrem e recuperem informações detalhadas sobre armas de fogo usando chamadas de ferramentas estruturadas em vez de integração manual de API.

Projetado para velocidade e simplicidade, o servidor conecta-se diretamente à API da Gunsnation e fornece uma interface limpa e padronizada para consultar produtos por marca, modelo, UPC ou categoria. Os assistentes também podem buscar especificações completas, imagens e metadados de armas de fogo individuais, tornando-o ideal para fluxos de trabalho de varejo, comparação e descoberta de produtos.

Construído em TypeScript e distribuído como um pacote npm, o servidor é fácil de instalar e executar localmente ou em ambientes hospedados. Com apenas uma chave de API e um cliente compatível com MCP, os desenvolvedores podem adicionar rapidamente acesso em tempo real a dados de armas de fogo às suas ferramentas de IA.

Principais recursos

• Ferramentas de pesquisa e consulta de armas de fogo compatíveis com MCP
• Acesso em tempo real ao catálogo de produtos da Gunsnation
• Instalação simples via npm ou npx
• Base de código TypeScript leve e amigável para desenvolvedores
• Autenticação segura por chave de API

Este projeto é ideal para desenvolvedores que criam assistentes de compras com IA, ferramentas de varejo ou experiências de descoberta de produtos que exigem dados atualizados de armas de fogo da Gunsnation.

Recursos

• Pesquisar Armas de Fogo: Pesquise o banco de dados de armas de fogo por nome, marca, modelo, UPC ou categoria
• Obter Detalhes da Arma de Fogo: Recupere detalhes abrangentes sobre uma arma de fogo específica, incluindo especificações e imagens

Instalação

npm install gunsnation-mcp

Ou use diretamente com npx:

npx gunsnation-mcp

Configuração

Variáveis de Ambiente

• GUNSNATION_API_KEY (obrigatório): Sua chave de API da Gunsnation
• GUNSNATION_API_URL (opcional): URL de API personalizada (padrão: https://api.gunsnation.com)

Configuração do Claude Desktop

Adicione ao seu arquivo de configuração do Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json no macOS):

{
  "mcpServers": {
    "gunsnation": {
      "command": "npx",
      "args": ["gunsnation-mcp"],
      "env": {
        "GUNSNATION_API_KEY": "your_api_key_here"
      }
    }
  }
}

Ferramentas Disponíveis

search_firearms

Pesquise o banco de dados de armas de fogo da Gunsnation.

Parâmetros:

• query (opcional): Consulta de pesquisa para nome, marca, modelo ou UPC da arma de fogo
• category (opcional): Filtro de categoria (ex.: "Handguns", "Rifles", "Shotguns")
• limit (opcional): Número máximo de resultados (1-100, padrão: 20)
• offset (opcional): Número de resultados a pular para paginação

Exemplo:

Search for Glock handguns: { "query": "glock", "category": "Handguns", "limit": 10 }

get_firearm

Obtenha informações detalhadas sobre uma arma de fogo específica.

Parâmetros:

• id (obrigatório): O ID da arma de fogo a ser recuperada

Exemplo:

Get firearm details: { "id": 12345 }

Obtendo uma Chave de API

1. Crie uma conta em gunsnation.com
2. Vá para Configurações
3. Clique em "Gerar Chave de API" na seção de Chave de API
4. Copie sua chave de API e mantenha-a segura

Limites de Taxa

• 60 requisições por minuto por chave de API

Desenvolvimento

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
GUNSNATION_API_KEY=your_key npm run dev

Licença

MIT