gunsnation

Gunsnation MCP 服务

Gunsnation MCP 服务是一个轻量级集成层，可通过模型上下文协议（MCP）向 AI 助手提供 Gunsnation 枪械目录。它支持兼容的 AI 客户端使用结构化工具调用搜索、筛选和获取详细的枪械信息，无需手动集成 API。

该服务以快速、简单为设计目标，可直接连接 Gunsnation API，并提供简洁、标准化的接口，按品牌、型号、UPC 或类别查询产品。助手还可以获取单件枪械的完整规格、图片和元数据，因此非常适用于零售、产品比较和产品发现工作流。

该服务使用 TypeScript 构建，并作为 npm 包分发，可轻松在本地或托管环境中安装和运行。开发者只需一个 API 密钥和兼容 MCP 的客户端，即可快速为 AI 工具添加实时枪械数据访问功能。

主要功能 • 兼容 MCP 的枪械搜索和查询工具 • 实时访问 Gunsnation 产品目录 • 通过 npm 或 npx 简单安装 • 轻量、便于开发者使用的 TypeScript 代码库 • 安全的 API 密钥身份验证

本项目适用于构建 AI 购物助手、零售工具或产品发现体验的开发者，这些应用需要获取 Gunsnation 的最新枪械数据。

功能

• 搜索枪械：按名称、品牌、型号、UPC 或类别搜索枪械数据库
• 获取枪械详情：获取特定枪械的全面详情，包括规格和图片

安装

npm install gunsnation-mcp

也可以直接使用 npx：

npx gunsnation-mcp

配置

环境变量

• GUNSNATION_API_KEY（必需）：你的 Gunsnation API 密钥
• GUNSNATION_API_URL（可选）：自定义 API URL（默认为 https://api.gunsnation.com）

Claude Desktop 配置

添加到你的 Claude Desktop 配置文件（macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json）：

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

可用工具

search_firearms

搜索 Gunsnation 枪械数据库。

参数：

• query（可选）：枪械名称、品牌、型号或 UPC 的搜索查询
• category（可选）：类别筛选条件（例如，“手枪”“步枪”“霰弹枪”）
• limit（可选）：结果数量上限（1-100，默认值：20）
• offset（可选）：分页时跳过的结果数量

示例：

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

get_firearm

获取特定枪械的详细信息。

参数：

• id（必需）：要获取的枪械 ID

示例：

Get firearm details: { "id": 12345 }

获取 API 密钥

1. 在 gunsnation.com 创建账户
2. 前往 Settings
3. 在 API Key 部分点击“Generate API Key”
4. 复制 API 密钥并妥善保管

速率限制

• 每个 API 密钥每分钟 60 个请求

开发

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
GUNSNATION_API_KEY=your_key npm run dev

许可证

MIT