GunsNPrices

GunsNPrices MCP 服务

一个 MCP 服务，可帮助 AI 助手解答枪械和弹药购物问题。它会读取枪械和弹药商品标题（品牌、型号、口径、弹匣容量、枪管长度、每盒发数），计算每发成本，并提供指向 GunsNPrices 页面的链接，这些页面会比较 40 多家美国枪械和弹药商店的当前价格。

它在本地运行，无需 API 密钥：所有内容均来自开源的 gunsnprices 解析器，以及 GunsNPrices 页面链接快照。它不会获取实时价格；对于“哪里最便宜”这类问题，助手会提供 GunsNPrices 页面供你查看。

工具

工具	功能
parse_product_title	标题 → 枪械或弹药、品牌、型号、口径、弹匣容量、枪管长度、每盒发数、每发成本、价格比较页面
identify_firearm_model	标题或描述 → 品牌、型号系列、确切型号（50 个品牌）；解码 Glock 零件编号
lookup_caliber	9mm Luger、300 BLK、12ga、6.5 CM → 标准口径名称、类型及其弹药价格页面
cost_per_round	价格 + 发数（或从标题中读取）→ 每发成本
find_price_comparison_pages	型号、品牌或口径 → GunsNPrices 价格比较页面，按具体程度从高到低排列
list_supported	支持型号识别的 50 个品牌，或已知的 293 种口径

所有工具均为只读，可离线使用。

安装

该服务是 npm 包 gunsnprices-mcp，使用 Node.js 18 或更高版本运行。

Claude Code

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

Claude Desktop：添加到 claude_desktop_config.json（设置 → 开发者 → 编辑配置）：

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

Cursor：在 ~/.cursor/mcp.json 中使用相同的代码块。

VS Code：.vscode/mcp.json：

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

Claude Desktop，一键安装：从最新版本下载 gunsnprices-mcp-<version>.mcpb 并打开（MCP Bundle，Claude Desktop 内含 Node.js）。

Docker：

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

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

可以询问的问题

• “G19 GEN5 9MM 4.02 15RD FS MOS 具体是什么？我可以在哪里比较价格？”
• “以下这些 9mm 商品中，哪个每发最便宜：$18.99 买 50 发、$289 买 1,000 发、$13.49 买 20 发？”
• “300 BLK 和 .300 AAC Blackout 是同一种口径吗？在哪里可以比较这种弹药的价格？”
• “把这份枪械标题电子表格整理为品牌、型号、口径和枪管长度。”

find_price_comparison_pages 对 “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" }
  ]
}

准确性

解析功能来自 gunsnprices 库。在来自 40 多家商店的 63,755 条商品信息中，对于网站已知型号的商品，该库在 99.97% 的情况下识别出的型号与 gunsnprices.com 相同；对于能识别出口径的枪械和弹药标题，口径识别准确率分别为 97.8% 和 94.9%。详情请参阅该库的 README。

相关项目

• 解析器库：npm、PyPI
• 口径和型号开放数据集：Hugging Face、GitHub、Kaggle

许可证

代码采用 MIT License。src/data/ 中的页面链接来自 GunsNPrices firearm-models 数据集，并采用 CC BY 4.0 许可：请注明 GunsNPrices (gunsnprices.com) 并附上链接。

如有问题或需要更正，请提交 issue，或发送邮件至 [email protected]。