AI家具・ホームプロダクトハブ - MCPサーバー

15個のツール | 300点以上の厳選製品 | 31カテゴリ | 80以上のブランド ミリ単位の精度での検索、厳選セット、AI可視性診断、OpenAPI 3.1スキーマ対応。 ChatGPT、Claude、Gemini、Cursor、Perplexity、およびMCP互換のAIエージェント向けに構築されています。

npm License: MIT

このプロジェクトの目的

AIエージェントが有用な推奨を行うためには、機械最適化された構造化製品データが必要です。このMCPサーバーは以下を提供します：

ジャストフィット検索: 「425mmの隙間に収まる棚を探して」と入力すると、1mm単位の精度で製品を返します
完全なソリューション: 1回の検索で、棚＋適合する収納ボックス＋床保護材＋ケーブルオーガナイザーを提案します
専門家によるキュレーション: インフルエンサーの選定、部屋のプリセット、バンドル販売、予算を抑えた代替案
後継品インテリジェンス: 廃番製品の場合、寸法互換性（fit_score 0-100）に基づいて後継品をランク付けします
AI可視性コンサルティング: ツールを呼び出すだけで、あらゆるWebサイトのAI発見可能性を診断します

クイックスタート

オプション 1: リモート（インストール不要）

ホストされているサーバーに直接接続します：

{
  "mcpServers": {
    "furniture-hub": {
      "url": "https://ai-furniture-hub.onrender.com/mcp"
    }
  }
}

オプション 2: npx (ローカル)

npx ai-furniture-hub

オプション 3: クローンして実行

git clone https://github.com/ONE8943/ai-furniture-hub.git
cd ai-furniture-hub
npm install
cp .env.example .env   # API keys optional - works with mock data
npm start               # stdio mode
npm run start:http      # HTTP mode at localhost:3000/mcp

ツール (15)

検索と発見

ツール	機能
`search_products`	キーワード、寸法(mm)、価格、色、カテゴリ、ブランドで300以上の製品を検索
`get_product_detail`	詳細スペック：内寸、消耗品、適合収納、キュレーション情報
`search_rakuten_products`	楽天市場のリアルタイム検索（価格やレビューを含む20万件以上のリスト）
`search_amazon_products`	自動SearchIndex付きのAmazonアフィリエイト検索URL生成
`suggest_by_space`	「600x400mmのスペースがある」→回転を考慮し、収まるすべての製品を提案
`identify_product`	ビジュアル説明から製品候補と型番を特定

コーディネートと比較

ツール	機能
`coordinate_storage`	棚＋収納ボックスのセット提案：段ごとの数量、合計コスト
`compare_products`	価格、サイズ、耐荷重、レビューに基づく製品比較（2〜5製品）
`find_replacement`	廃番モデルから後継品＋`fit_score`付きの寸法互換代替品を提案
`calc_room_layout`	配置座標を用いたフロアプランの長方形パッキング計算
`get_related_items`	アクセサリーチェーン：必須アイテム、保護材、消耗品、ハック代替品（深さ1-2）

キュレーションとインテリジェンス

ツール	機能
`get_curated_sets`	バンドル、ルームプリセット、インフルエンサー選定、ハックセット。タイプ/シーン/予算でフィルタリング
`get_popular_products`	楽天データに基づくカテゴリ別トレンド製品
`list_categories`	31のカテゴリを件数、ブランド、サンプル付きで閲覧
`diagnose_ai_visibility`	AI可視性監査：llms.txt、robots.txt、JSON-LD、OGP、スコア0-100

プロンプトワークフロー (3)

プロンプト	フロー
`room_coordinator`	スペース寸法から棚＋ボックス＋保護材を数量とコスト付きで提案
`moving_checklist`	フロアプランタイプから部屋ごとの購入チェックリストを予算付きで作成
`product_showdown`	2つの製品を比較し、アクセサリーやランニングコストを含めた詳細比較

製品カテゴリ (31)

エリア	カテゴリ
収納	棚、カラーボックス、収納ケース、衣類収納、スチールラック、クローゼット収納、ファイル収納
家具	デスク、テレビ台、本棚、ダイニング、ソファ・椅子、寝具
部屋別	キッチン、ランドリー、バス、玄関、ベビーセーフティ
ハードウェア	突っ張り棒、保護材、パーツ・アクセサリー、ワゴン
家電	生活家電、キッチン家電、空気清浄、スマートホーム
テック・ライフ	PC周辺機器、美容家電、ガジェット、ヘルス・フィットネス
インテリア	カーテン・ブラインド

主な機能

シンデレラフィット検索

すべての寸法はミリメートル単位（外寸および内寸）。1mmの許容範囲で特定のスペースに収まる製品を見つけます。回転を考慮し、幅と奥行きを入れ替えた場合に収まるかどうかも自動的にチェックします。

キュレーションセット

バンドル: 「新生活スターターキット」、「在宅ワークセット」
ルームプリセット: IKEAスタイルの完成された部屋構成
インフルエンサー選定: YouTuberや雑誌によるリアルな推奨
ハックセット: 予算を抑えた代替案（1000円のアクセサリーを100均で代用など）

寸法互換性のある代替品検索

廃番製品の場合、find_replacementが以下を返します：

DB登録済みの後継品
fit_score（0-100）付きの寸法互換代替品
楽天のライブ検索結果

AI可視性診断 (AIO)

diagnose_ai_visibilityはあらゆるURLを監査します：

llms.txtの存在
robots.txtのAIクローラーアクセス
構造化データ (JSON-LD, Schema.org)
OGPタグ
海外対応状況 (英語メタデータ、多通貨)
スコア (0-100)、グレード (A-F)、実行可能な推奨事項を返します

アトリビューションと分析

すべてのAPIレスポンスには、一意のattribution_idを含む_attributionメタデータが含まれており、以下が可能です：

コールごとの収益化のためのトラッキング
ソース検出 (Apify, RapidAPI, 直接)
収益配分用の貢献ログ

APIと統合

OpenAPI 3.1 スキーマ

RapidAPIやマーケットプレイス統合のために、/openapi.yaml で完全なOpenAPI仕様を利用可能です。

AI発見エンドポイント

ファイル	URL	目的
llms.txt	/llms.txt	AIエージェントの概要
llms-full.txt	/llms-full.txt	完全なツールスキーマと例
OpenAPI	/openapi.yaml	REST API仕様
Server Card	/.well-known/mcp/server-card.json	機械可読メタデータ
context.md	/context.md	構造化されたAIコンテキスト
robots.txt	/robots.txt	AIクローラーの権限

MCPリソース

furniture-hub://llms.txt
furniture-hub://llms-full.txt

アーキテクチャ

AI Agent (ChatGPT, Claude, Gemini, Cursor, Perplexity, ...)
    | MCP (stdio or Streamable HTTP)
    v
+-----------------------------------------------------------+
|  15 Tools + 3 Prompts                                     |
+-----------------------------------------------------------+
|  300+ Products | 31 Categories | 80+ Brands               |
|  Curated Sets: bundles, room presets, influencer picks     |
|  Compatibility DB: dimension-based fit scoring             |
|  Attribution: per-request tracking with attribution_id     |
+-----------------------------------------------------------+
|  Adapters: Rakuten API / Amazon URL / Nitori               |
|  Affiliate Engine + Gap Detector + Analytics               |
+-----------------------------------------------------------+
    |
    v
  /llms.txt        /llms-full.txt        /openapi.yaml
  /context.md      /.well-known/mcp/     /robots.txt

環境変数

変数	必須	説明
`DEPLOYMENT_MODE`	いいえ	`private` (デフォルト、アフィリエイトON) または `public` (マーケットプレイス用、アフィリエイトOFF)
`AFFILIATE_ID_AMAZON`	いいえ	Amazonアソシエイトタグ
`AFFILIATE_ID_RAKUTEN`	いいえ	楽天アフィリエイトID
`RAKUTEN_APP_ID`	いいえ	楽天APIアプリケーションID
`RAKUTEN_API_MOCK`	いいえ	`true` (デフォルト、モックデータ) または `false` (ライブデータ)

すべての環境変数はオプションです。サーバーはモックデータを使用してすぐに動作します。

デプロイ

プラットフォーム	URL
Render	`https://ai-furniture-hub.onrender.com/mcp`
npm	`npx ai-furniture-hub`

テスト

npm run test:ci      # Vitest
npm run test:all     # Full legacy suite

貢献

IssueやPRを歓迎します。GitHub Issues を参照してください。

ライセンス

MIT

Japanese / 日本語

AI Furniture & Home Product Hub は家具・家電・ガジェット等のAIエージェント向けMCPサーバーです。

300+商品、31カテゴリ、80+ブランド のキュレーション済みカタログ
mm精度の寸法検索 - 「幅425mmの隙間にぴったり収まる棚」を即座に発見
関連アイテムチェーン - 1商品から3-5個の関連商品（必須アクセサリ、保護材、消耗品）
キュレーション - バンドル提案、ルームプリセット、インフルエンサーおすすめ、100均代用ハック
後継品検索 - 廃番商品から寸法互換の代替品をfit_scoreで提案
AI可視性診断（AIO） - Webサイトの「AIからの見え方」を0-100でスコアリング
OpenAPI 3.1 - RapidAPI等のマーケットプレイス連携対応

運営

ONE, Inc.

ai-furniture-hub