Gunsnation MCP

Servidor MCP de Gunsnation

El Servidor MCP de Gunsnation es una capa de integración ligera que expone el catálogo de armas de fuego de Gunsnation a asistentes de IA a través del Protocolo de Contexto de Modelo (MCP). Permite que clientes de IA compatibles busquen, filtren y recuperen información detallada sobre armas de fuego mediante llamadas a herramientas estructuradas, en lugar de una integración manual con la API.

Diseñado para ser rápido y sencillo, el servidor se conecta directamente a la API de Gunsnation y proporciona una interfaz limpia y estandarizada para consultar productos por marca, modelo, UPC o categoría. Los asistentes también pueden obtener especificaciones completas, imágenes y metadatos de armas de fuego individuales, lo que lo hace ideal para flujos de trabajo de venta minorista, comparación y descubrimiento de productos.

Desarrollado en TypeScript y distribuido como un paquete npm, el servidor es fácil de instalar y ejecutar localmente o en entornos alojados. Con solo una clave de API y un cliente compatible con MCP, los desarrolladores pueden agregar rápidamente acceso en tiempo real a datos de armas de fuego a sus herramientas de IA.

Características principales

• Herramientas de búsqueda y consulta de armas de fuego compatibles con MCP
• Acceso en tiempo real al catálogo de productos de Gunsnation
• Instalación sencilla mediante npm o npx
• Código TypeScript ligero y fácil de usar para desarrolladores
• Autenticación segura mediante clave de API

Este proyecto es ideal para desarrolladores que crean asistentes de compras con IA, herramientas minoristas o experiencias de descubrimiento de productos que requieran datos actualizados de armas de fuego de Gunsnation.

Características

• Buscar armas de fuego: Busca en la base de datos de armas de fuego por nombre, marca, modelo, UPC o categoría
• Obtener detalles de un arma de fuego: Recupera información completa sobre un arma de fuego específica, incluidas especificaciones e imágenes

Instalación

npm install gunsnation-mcp

O úsalo directamente con npx:

npx gunsnation-mcp

Configuración

Variables de entorno

• GUNSNATION_API_KEY (obligatorio): Tu clave de API de Gunsnation
• GUNSNATION_API_URL (opcional): URL de API personalizada (por defecto https://api.gunsnation.com)

Configuración de Claude Desktop

Agrega esto a tu archivo de configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

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

Herramientas disponibles

search_firearms

Busca en la base de datos de armas de fuego de Gunsnation.

Parámetros:

• query (opcional): Consulta de búsqueda por nombre, marca, modelo o UPC del arma de fuego
• category (opcional): Filtro de categoría (por ejemplo, "Pistolas", "Rifles", "Escopetas")
• limit (opcional): Número máximo de resultados (1-100, por defecto: 20)
• offset (opcional): Número de resultados a omitir para la paginación

Ejemplo:

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

get_firearm

Obtén información detallada sobre un arma de fuego específica.

Parámetros:

• id (obligatorio): El ID del arma de fuego a recuperar

Ejemplo:

Get firearm details: { "id": 12345 }

Cómo obtener una clave de API

1. Crea una cuenta en gunsnation.com
2. Ve a Configuración
3. Haz clic en "Generar clave de API" en la sección de clave de API
4. Copia tu clave de API y mantenla segura

Límites de velocidad

• 60 solicitudes por minuto por clave de API

Desarrollo

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
GUNSNATION_API_KEY=your_key npm run dev

Licencia

MIT