gunsnation

Gunsnation MCP サーバー

Gunsnation MCP サーバーは、Model Context Protocol（MCP）を通じて Gunsnation の銃器カタログを AI アシスタントに公開する、軽量な統合レイヤーです。互換性のある AI クライアントは、手動で API を統合する代わりに、構造化されたツール呼び出しを使って銃器情報を検索、絞り込み、取得できます。

速度とシンプルさを重視して設計されたこのサーバーは、Gunsnation API に直接接続し、ブランド、モデル、UPC、カテゴリーを指定して商品を検索できる、すっきりとした標準インターフェースを提供します。アシスタントは、個々の銃器の詳細な仕様、画像、メタデータも取得できるため、小売、比較、商品発見のワークフローに最適です。

TypeScript で構築され、npm パッケージとして配布されるこのサーバーは、ローカル環境にもホスト環境にも簡単にインストールして実行できます。API キーと MCP 互換クライアントがあれば、開発者は AI ツールにリアルタイムの銃器データへのアクセスをすばやく追加できます。

主な機能 • MCP 互換の銃器検索・照会ツール • Gunsnation の商品カタログへのリアルタイムアクセス • npm または npx による簡単なインストール • 軽量で開発者に使いやすい TypeScript コードベース • 安全な API キー認証

このプロジェクトは、Gunsnation の最新の銃器データを必要とする AI ショッピングアシスタント、小売ツール、商品発見エクスペリエンスを構築する開発者に最適です。

機能

• 銃器の検索：銃器データベースを名前、ブランド、モデル、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（任意）：カテゴリーの絞り込み（例：「Handguns」、「Rifles」、「Shotguns」）
• 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 キーごとに 1 分あたり 60 件のリクエスト

開発

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
GUNSNATION_API_KEY=your_key npm run dev

ライセンス

MIT