GunsNPrices

Analiza títulos de armas y municiones (modelo, calibre, costo por cartucho); encuentra páginas de comparación de precios de GunsNPrices

GitHub

Documentación

Servidor MCP de GunsNPrices

Un servidor MCP que ayuda a los asistentes de IA con preguntas sobre compras de armas y municiones. Lee títulos de productos de armas de fuego y municiones (marca, modelo, calibre, capacidad del cargador, longitud del cañón, cartuchos por caja), calcula el costo por cartucho y apunta a las páginas de GunsNPrices que comparan precios actuales en más de 40 tiendas de armas y municiones de EE. UU.

Se ejecuta localmente y no necesita clave de API: todo proviene del analizador de código abierto gunsnprices y una instantánea de los enlaces de las páginas de GunsNPrices. No obtiene precios en vivo; para preguntas de "dónde es más barato", el asistente obtiene las páginas de GunsNPrices para enviarte a ellas.

Herramientas

Herramienta	Qué hace
`parse_product_title`	Título → arma de fuego o munición, marca, modelo, calibres, capacidad del cargador, longitud del cañón, cartuchos por caja, costo por cartucho, páginas de comparación de precios
`identify_firearm_model`	Título o descripción → marca, familia de modelos, modelo exacto (50 marcas); decodifica números de pieza de Glock
`lookup_caliber`	`9mm Luger`, `300 BLK`, `12ga`, `6.5 CM` → nombre de calibre estándar, tipo y su página de precios de munición
`cost_per_round`	Precio + cantidad de cartuchos (o un título para leerlo) → costo por cartucho
`find_price_comparison_pages`	Modelo, marca o calibre → páginas de GunsNPrices que comparan precios actuales, las más específicas primero
`list_supported`	Las 50 marcas con reconocimiento de modelos, o los 293 calibres conocidos

Todas las herramientas son de solo lectura y funcionan sin conexión.

Instalación

El servidor es el paquete npm gunsnprices-mcp y se ejecuta con Node.js 18 o superior.

Claude Code

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

Claude Desktop: agrégalo a claude_desktop_config.json (Configuración → Desarrollador → Editar configuración):

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

Cursor: el mismo bloque en ~/.cursor/mcp.json.

VS Code: .vscode/mcp.json:

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

Claude Desktop, un clic: descarga gunsnprices-mcp-<version>.mcpb desde la última versión y ábrelo (MCP Bundle, Node.js incluido con 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"] }
  }
}

Cosas para preguntar

"¿Qué es exactamente un G19 GEN5 9MM 4.02 15RD FS MOS y dónde puedo comparar precios?"
"¿Cuál de estas ofertas de 9mm es la más barata por cartucho: $18.99 por 50, $289 por 1,000, $13.49 por 20?"
"¿Es 300 BLK lo mismo que .300 AAC Blackout? ¿Dónde comparo precios de munición para eso?"
"Limpia esta hoja de cálculo de títulos de armas en marca, modelo, calibre y longitud del cañón."

Ejemplo 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" }
  ]
}

Precisión

El análisis es la biblioteca gunsnprices. En 63,755 listados de más de 40 tiendas, reconoce el mismo modelo que gunsnprices.com en el 99.97% de los casos donde el sitio conoce el modelo, y acierta el calibre en el 97.8% de los títulos de armas de fuego y el 94.9% de los títulos de munición donde encuentra uno. Los detalles están en el README de la biblioteca.

Relacionados

Biblioteca de análisis: npm, PyPI
Conjuntos de datos abiertos de calibres y modelos: Hugging Face, GitHub, Kaggle

Licencia

El código está bajo la Licencia MIT. Los enlaces de páginas en src/data/ provienen del conjunto de datos firearm-models de GunsNPrices y están bajo CC BY 4.0: acredita a GunsNPrices (gunsnprices.com) con un enlace.

Preguntas y correcciones: abre un issue o escribe a app@gunsnprices.com.