smartmart-mcp 1.0.0

package/lib/api-client.js

@@ -0,0 +1,88 @@
+/**
+ * Smart-Mart MCP API Client
+ * ロボティクス横断プラットフォーム（Smart-Mart / Physical AI Rental / Humanoid Mart / Humanoid Jobs）
+ */
+
+export class SmartMartApiClient {
+    constructor(apiKey, baseUrl = 'https://smart-mart.jp') {
+        this.apiKey = apiKey;
+        this.baseUrl = baseUrl.replace(/\/$/, '');
+    }
+
+    /**
+     * 認証ありリクエスト（標準）
+     */
+    async request(action, params = {}) {
+        const url = `${this.baseUrl}/api/mcp.php`;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${this.apiKey}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ action, params }),
+        });
+
+        const json = await response.json();
+        if (!response.ok || !json.success) {
+            throw new Error(json.message || `API error: ${response.status}`);
+        }
+        return json.data;
+    }
+
+    /**
+     * ヘルスチェック（認証不要）
+     */
+    async health() {
+        const url = `${this.baseUrl}/api/mcp.php`;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ action: 'health' }),
+        });
+        return response.json();
+    }
+
+    // ==========================================
+    // 商品検索 (5)
+    // ==========================================
+
+    async productsSearch(params)    { return this.request('products.search', params); }
+    async productsDetail(slug)      { return this.request('products.detail', { slug }); }
+    async productsCompare(slugs)    { return this.request('products.compare', { slugs }); }
+    async categoriesList()          { return this.request('categories.list'); }
+    async brandsList(params = {})   { return this.request('brands.list', params); }
+
+    // ==========================================
+    // レンタル (2)
+    // ==========================================
+
+    async rentalSearch(params)          { return this.request('rental.search', params); }
+    async rentalAvailability(slug)      { return this.request('rental.availability', { slug }); }
+
+    // ==========================================
+    // 購入・リース (2)
+    // ==========================================
+
+    async purchaseOptions(slug)                      { return this.request('purchase.options', { slug }); }
+    async leaseEstimate(slug, termMonths)             { return this.request('lease.estimate', { slug, term_months: termMonths }); }
+
+    // ==========================================
+    // 買取査定 (1)
+    // ==========================================
+
+    async buybackEstimate(params)   { return this.request('buyback.estimate', params); }
+
+    // ==========================================
+    // 求人 (2)
+    // ==========================================
+
+    async jobsSearch(params)        { return this.request('jobs.search', params); }
+    async jobsByRobot(robotSlug)    { return this.request('jobs.by_robot', { robot_slug: robotSlug }); }
+
+    // ==========================================
+    // ユーティリティ (1)
+    // ==========================================
+
+    async consultRequest(params)    { return this.request('consult.request', params); }
+}

package/lib/tools.js

@@ -0,0 +1,336 @@
+/**
+ * Smart-Mart MCP ツール定義 (14ツール)
+ *
+ * カテゴリ:
+ *   商品検索 (5): products.search / products.detail / products.compare / categories.list / brands.list
+ *   レンタル (2): rental.search / rental.availability
+ *   購入・リース (2): purchase.options / lease.estimate
+ *   買取査定 (1): buyback.estimate
+ *   求人 (2): jobs.search / jobs.by_robot
+ *   ユーティリティ (2): health / consult.request
+ */
+
+export const TOOLS = [
+    // ============================================================
+    // ユーティリティ (2)
+    // ============================================================
+    {
+        name: 'health',
+        description: 'Smart-Mart MCPサーバーのヘルスチェック。認証不要。DB接続確認・商品数・カテゴリ一覧・稼働サイト一覧を返す',
+        inputSchema: { type: 'object', properties: {} },
+    },
+
+    // ============================================================
+    // 商品検索 (5)
+    // ============================================================
+    {
+        name: 'products_search',
+        description: 'Smart-Mart / Physical AI Rental / Humanoid Mart の全サイト横断で商品を検索。ヒューマノイドロボット・XR/VRデバイス・ドローン・AIデバイスなどを横断検索できる。価格・カテゴリ・ブランド・コンディションでフィルタ可能',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                keyword: {
+                    type: 'string',
+                    description: 'キーワード（商品名・ブランド名など）',
+                },
+                category: {
+                    type: 'string',
+                    enum: ['humanoid', 'xr', 'drone', 'ai', 'quadruped', 'industrial'],
+                    description: '商品カテゴリ。humanoid=ヒューマノイドロボット, xr=XR/VRデバイス, drone=ドローン, ai=AIデバイス, quadruped=4足歩行ロボット, industrial=産業用ロボット',
+                },
+                brand: {
+                    type: 'string',
+                    description: 'ブランドID（brands.listで取得）',
+                },
+                min_price: {
+                    type: 'integer',
+                    description: '最低価格（円・新品販売価格基準）',
+                },
+                max_price: {
+                    type: 'integer',
+                    description: '最高価格（円・新品販売価格基準）',
+                },
+                condition: {
+                    type: 'string',
+                    enum: ['new', 'used'],
+                    description: '商品状態。new=新品, used=中古',
+                },
+                available_only: {
+                    type: 'boolean',
+                    description: 'trueの場合、在庫あり商品のみ返す（デフォルト: false）',
+                },
+            },
+        },
+    },
+    {
+        name: 'products_detail',
+        description: '商品の詳細情報と全サイト別価格比較を取得。スペック・画像・各サイトの新品/中古/レンタル/リース/買取の価格を一覧で確認できる',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                slug: {
+                    type: 'string',
+                    description: '商品スラッグ（例: figure-03, meta-quest-3, dji-mavic-3-pro）',
+                },
+            },
+            required: ['slug'],
+        },
+    },
+    {
+        name: 'products_compare',
+        description: '複数商品（最大5点）のスペック・価格を並べた比較表を生成。どのロボットを選ぶか検討中のユーザーへの提案に最適',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                slugs: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    minItems: 2,
+                    maxItems: 5,
+                    description: '比較する商品スラッグの配列（2〜5件）',
+                },
+            },
+            required: ['slugs'],
+        },
+    },
+    {
+        name: 'categories_list',
+        description: '取扱カテゴリ一覧と各カテゴリの商品数を取得',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'brands_list',
+        description: '取扱ブランド一覧を取得。カテゴリで絞り込み可能',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                category: {
+                    type: 'string',
+                    enum: ['humanoid', 'xr', 'drone', 'ai', 'quadruped', 'industrial'],
+                    description: '絞り込むカテゴリ（省略時は全カテゴリ）',
+                },
+            },
+        },
+    },
+
+    // ============================================================
+    // レンタル (2)
+    // ============================================================
+    {
+        name: 'rental_search',
+        description: 'レンタル可能な商品を検索（Physical AI Rental / Smart-Mart Rental）。日額・週額・月額・長期月額でフィルタ可能',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                category: {
+                    type: 'string',
+                    enum: ['humanoid', 'xr', 'drone', 'ai', 'quadruped', 'industrial'],
+                    description: 'カテゴリ絞り込み',
+                },
+                brand: {
+                    type: 'string',
+                    description: 'ブランドID',
+                },
+                max_monthly_price: {
+                    type: 'integer',
+                    description: '月額上限（円）',
+                },
+                period: {
+                    type: 'string',
+                    enum: ['daily', 'weekly', 'monthly', 'long'],
+                    description: '料金プランのタイプ。daily=日額, weekly=週額, monthly=月額, long=長期月額（3ヶ月以上）',
+                },
+            },
+        },
+    },
+    {
+        name: 'rental_availability',
+        description: '特定商品のレンタル在庫・空き状況と料金（日額/週額/月額/長期月額）を確認',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                slug: {
+                    type: 'string',
+                    description: '商品スラッグ',
+                },
+            },
+            required: ['slug'],
+        },
+    },
+
+    // ============================================================
+    // 購入・リース (2)
+    // ============================================================
+    {
+        name: 'purchase_options',
+        description: '購入オプションを全サイト横断で比較。新品・中古・各サイトの在庫状況・価格を一覧表示。最安値のサイトを見つけるのに使う',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                slug: {
+                    type: 'string',
+                    description: '商品スラッグ',
+                },
+            },
+            required: ['slug'],
+        },
+    },
+    {
+        name: 'lease_estimate',
+        description: 'リース月額の見積もりを計算。契約期間（12〜60ヶ月）別の月額・総コスト・購入との差額を提示',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                slug: {
+                    type: 'string',
+                    description: '商品スラッグ',
+                },
+                term_months: {
+                    type: 'integer',
+                    enum: [12, 24, 36, 48, 60],
+                    description: 'リース期間（月数）',
+                },
+            },
+            required: ['slug', 'term_months'],
+        },
+    },
+
+    // ============================================================
+    // 買取査定 (1)
+    // ============================================================
+    {
+        name: 'buyback_estimate',
+        description: 'ロボット・XRデバイス・ドローン等の買取査定価格を即時算出。コンディション・付属品・年式に応じた査定レンジ（min/max）を返す',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                brand: {
+                    type: 'string',
+                    description: 'メーカー名（例: Meta, Boston Dynamics, DJI, Figure）',
+                },
+                model: {
+                    type: 'string',
+                    description: '商品名またはスラッグ（例: meta-quest-3, Quest 3, dji-mavic-3-pro）',
+                },
+                condition: {
+                    type: 'string',
+                    enum: ['S', 'A', 'B', 'C', 'D'],
+                    description: 'コンディション。S=未使用品/新品同様, A=良好（使用感少）, B=並（使用感あり）, C=難あり（軽微な傷・不具合）, D=ジャンク',
+                },
+                year: {
+                    type: 'integer',
+                    description: '購入年（例: 2023）',
+                },
+                accessories: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: '付属品リスト（例: ["充電ケーブル", "純正ケース", "コントローラー"]）',
+                },
+            },
+            required: ['brand', 'model', 'condition'],
+        },
+    },
+
+    // ============================================================
+    // 求人 (2)
+    // ============================================================
+    {
+        name: 'jobs_search',
+        description: 'Humanoid Jobsのロボット関連求人を検索。ヒューマノイドロボット・自動化・AI導入を推進する企業の求人を横断検索',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                keyword: {
+                    type: 'string',
+                    description: 'キーワード（職種・スキル・企業名など）',
+                },
+                location: {
+                    type: 'string',
+                    description: '勤務地（例: 東京, 大阪, リモート）',
+                },
+                employment_type: {
+                    type: 'string',
+                    enum: ['full_time', 'part_time', 'contract', 'freelance'],
+                    description: '雇用形態',
+                },
+                min_salary: {
+                    type: 'integer',
+                    description: '下限年収（万円）',
+                },
+            },
+        },
+    },
+    {
+        name: 'jobs_by_robot',
+        description: '特定のロボット（商品）を導入・活用している企業の求人を取得。「このロボットを扱う仕事がしたい」というユーザーの要求に対応',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                robot_slug: {
+                    type: 'string',
+                    description: 'ロボットのスラッグ（例: figure-03, atlas, spot）',
+                },
+            },
+            required: ['robot_slug'],
+        },
+    },
+
+    // ============================================================
+    // ユーティリティ (1)
+    // ============================================================
+    {
+        name: 'consult_request',
+        description: '購入・レンタル・リース・買取・修理に関する無料相談を申し込む。Smart-Martの専門スタッフが対応。inquiry_idを返す',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: {
+                    type: 'string',
+                    description: '相談者氏名',
+                },
+                email: {
+                    type: 'string',
+                    description: 'メールアドレス',
+                },
+                phone: {
+                    type: 'string',
+                    description: '電話番号（任意）',
+                },
+                inquiry_type: {
+                    type: 'string',
+                    enum: ['purchase', 'rental', 'lease', 'buyback', 'repair'],
+                    description: '相談種別。purchase=購入, rental=レンタル, lease=リース, buyback=買取, repair=修理',
+                },
+                message: {
+                    type: 'string',
+                    description: '相談内容（具体的な要件・予算・用途など）',
+                },
+                product_slug: {
+                    type: 'string',
+                    description: '対象商品のスラッグ（任意・特定商品についての相談の場合）',
+                },
+            },
+            required: ['name', 'email', 'inquiry_type', 'message'],
+        },
+    },
+];
+
+/**
+ * ツール名 → APIアクションのマッピング
+ */
+export const ACTION_MAP = {
+    'health':               'health',
+    'products_search':      'products.search',
+    'products_detail':      'products.detail',
+    'products_compare':     'products.compare',
+    'categories_list':      'categories.list',
+    'brands_list':          'brands.list',
+    'rental_search':        'rental.search',
+    'rental_availability':  'rental.availability',
+    'purchase_options':     'purchase.options',
+    'lease_estimate':       'lease.estimate',
+    'buyback_estimate':     'buyback.estimate',
+    'jobs_search':          'jobs.search',
+    'jobs_by_robot':        'jobs.by_robot',
+    'consult_request':      'consult.request',
+};

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "smartmart-mcp",
+  "version": "1.0.0",
+  "description": "MCP Server for Smart-Mart Robotics Platform - 14 tools for product search, rental, purchase, lease, buyback valuation, and job listings across Smart-Mart, Physical AI Rental, Humanoid Mart, and Humanoid Jobs.",
+  "main": "server.js",
+  "type": "module",
+  "bin": {
+    "smartmart-mcp": "server.js"
+  },
+  "scripts": {
+    "start": "node server.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "smartmart",
+    "robotics",
+    "humanoid",
+    "xr",
+    "drone",
+    "ai-hardware",
+    "rental",
+    "lease",
+    "buyback",
+    "claude-code"
+  ],
+  "files": [
+    "server.js",
+    "lib/**/*.js",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/asi-productions/mothership"
+  },
+  "author": "ASI Productions",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  }
+}

package/server.js

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+
+/**
+ * Smart-Mart Robotics MCP Server
+ * ロボティクス横断プラットフォーム
+ *   Smart-Mart + Physical AI Rental + Humanoid Mart + Humanoid Jobs
+ *
+ * 14ツール:
+ *   商品検索 (5): products_search / products_detail / products_compare / categories_list / brands_list
+ *   レンタル (2): rental_search / rental_availability
+ *   購入・リース (2): purchase_options / lease_estimate
+ *   買取査定 (1): buyback_estimate
+ *   求人 (2): jobs_search / jobs_by_robot
+ *   ユーティリティ (2): health / consult_request
+ *
+ * 起動方法:
+ *   SMARTMART_API_KEY=sm_xxx node server.js
+ *   SMARTMART_API_KEY=sm_xxx SMARTMART_BASE_URL=https://smart-mart.jp node server.js
+ */
+
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { SmartMartApiClient } from './lib/api-client.js';
+import { TOOLS, ACTION_MAP } from './lib/tools.js';
+
+const API_KEY  = process.env.SMARTMART_API_KEY  || '';
+const BASE_URL = process.env.SMARTMART_BASE_URL  || 'https://smart-mart.jp';
+
+if (!API_KEY) {
+    console.error('[smartmart-mcp] Warning: SMARTMART_API_KEY is not set.');
+}
+
+const client = new SmartMartApiClient(API_KEY, BASE_URL);
+
+const server = new Server(
+    { name: 'smartmart-mcp-server', version: '1.0.0' },
+    { capabilities: { tools: {} } }
+);
+
+// ==========================================
+// Handlers
+// ==========================================
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: TOOLS,
+}));
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    const action = ACTION_MAP[name];
+
+    if (!action) {
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: `Unknown tool: ${name}` }) }],
+            isError: true,
+        };
+    }
+
+    try {
+        let result;
+        if (name === 'health') {
+            result = await client.health();
+        } else {
+            result = await client.request(action, args || {});
+        }
+
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        };
+    } catch (error) {
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: error.message }) }],
+            isError: true,
+        };
+    }
+});
+
+// ==========================================
+// Start
+// ==========================================
+
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`[smartmart-mcp] Server started (stdio, ${TOOLS.length} tools)`);
+}
+
+main().catch((error) => {
+    console.error('[smartmart-mcp] Fatal error:', error);
+    process.exit(1);
+});