AI Furniture & Home Product Hub

io.github.ONE8943由 GitHub 帳號 ONE8943 發布v6.3.0更新於 Oct 27, 2026

MCP server for mm-precision furniture search, fit checks, curated sets, and AIO audits.

已驗證Streamable HTTP可網頁執行效率與工作流資料與分析商業與電商

概覽

AI 產生的概覽

面向家具與居家用品的目錄伺服器，支援毫米級尺寸搜尋、空間適配檢查、套裝推薦與聯盟購買連結。

可以做什麼
  • 依關鍵字、毫米尺寸、價格、顏色、品牌或分類檢索精選家具、收納與居家商品，並查看完整規格。
  • 判斷商品能否放入指定空間或房間配置，為層架搭配收納盒，並對 2 至 5 件商品做並排比較。
  • 查找配件、耗材與相關商品，並為停產型號尋找尺寸相容的替代品。
  • 取得精選套裝、房間預設組合、達人推薦與省錢替代方案，以及熱門商品。
  • 查詢樂天即時商品，並產生 Amazon 聯盟搜尋連結。
  • 藉由參照物從照片估算實際尺寸、依外觀描述辨識商品，並評估網站的 AI 可見度分數。
適用情境
適合在協助使用者挑選必須精準符合某個縫隙或房間的家具與收納用品、規劃成套搭配、比較型號或替換停產商品時使用。也適合產生聯盟購買連結，以及快速檢查網站對 AI 代理的可見程度。
執行需求
可使用遠端 Streamable HTTP 端點，或以 Node.js 在本機執行 npm 套件。無需驗證或 API 金鑰，所有環境變數皆為選用，預設以模擬資料即可運作。取得樂天即時結果需要樂天應用程式 ID 並關閉模擬模式。
安裝前請注意
回傳內容圍繞聯盟連結與逐次呼叫歸因統計建構，推薦帶有變現目的。即時購物結果依賴樂天與 Amazon 等第三方服務，Amazon 結果僅為產生的搜尋連結而非商品資料。照片量測與商品辨識依賴助理自身的視覺輸出。配置與適配結果為估算，未考慮門片與動線。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 AI Furniture & Home Product Hub，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.ONE8943%2Fai-furniture-hub/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "ai-furniture-home-product-hub": {
      "type": "http",
      "url": "https://ai-furniture-hub.onrender.com/mcp"
    }
  }
}

README

AI Furniture & Home Product Hub - MCP Server

15 tools | 355+ curated products | 31 categories | 90+ brands Millimeter-precision search, curated sets, AI visibility diagnosis, OpenAPI 3.1 schema. Built for ChatGPT, Claude, Gemini, Cursor, Perplexity, and any MCP-compatible AI agent.

[CI] [npm] [License: MIT]

Discovery & Install

  • MCP Registry name: io.github.ONE8943/ai-furniture-hub
  • Remote MCP endpoint: https://ai-furniture-hub.onrender.com/mcp
  • Well-known discovery: https://ai-furniture-hub.onrender.com/.well-known/mcp.json
  • npm package: ai-furniture-hub

If your MCP client supports registry search, search for io.github.ONE8943/ai-furniture-hub or AI Furniture & Home Product Hub. If your client supports direct remote MCP, connect it to https://ai-furniture-hub.onrender.com/mcp.

Why This Exists

AI agents need structured, machine-optimized product data to make useful recommendations. This MCP server provides:

  • Exact-fit search: "Find a shelf that fits a 425mm gap" returns products with 1mm accuracy
  • Complete solutions: One search returns the shelf + matching storage boxes + floor protection + cable organizers
  • Curated by experts: Influencer picks, room presets, bundle deals, and budget hack alternatives
  • Replacement intelligence: Discontinued product? Get successors ranked by dimension compatibility (fit_score 0-100)
  • AI visibility consulting: Diagnose any website's AI discoverability with a single tool call

Quick Start

Option 1: Remote (Cursor / Claude / VS Code / ChatGPT)

Connect directly to the hosted server:

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

Works in any MCP client that accepts a remote Streamable HTTP URL.

Option 2: npx (local)

bash
npx ai-furniture-hub

Option 3: Clone & Run

bash
git clone https://github.com/ONE8943/ai-furniture-hub.gitcd ai-furniture-hubnpm installcp .env.example .env   # API keys optional - works with mock datanpm start               # stdio modenpm run start:http      # HTTP mode at localhost:3000/mcp

Tools (15)

Search & Discovery

ToolWhat It Does
search_productsSearch 300+ products by keyword, dimensions (mm), price, color, category, brand
get_product_detailFull specs: inner dimensions, consumables, compatible storage, curations
search_rakuten_productsReal-time Rakuten Ichiba search (200K+ listings with prices & reviews)
search_amazon_productsAmazon affiliate search URL generation with auto SearchIndex
suggest_by_space"I have a 600x400mm space" -> everything that fits, rotation-aware
identify_productVisual description -> product candidates with model numbers

Coordination & Comparison

ToolWhat It Does
coordinate_storageShelf + storage box set proposals: quantity per tier, total cost
compare_productsSide-by-side comparison (2-5 products) on price, size, load, reviews
find_replacementDiscontinued model -> successors + dimension-compatible alternatives with fit_score
calc_room_layoutFloor-plan rectangle packing with placement coordinates
get_related_itemsAccessory chains: required items, protection, consumables, hack substitutes (depth 1-2)

Curation & Intelligence

ToolWhat It Does
get_curated_setsBundles, room presets, influencer picks, hack sets. Filter by type/scene/budget
get_popular_productsTrending products by category with Rakuten data
list_categoriesBrowse 31 categories with counts, brands, samples
diagnose_ai_visibilityAI visibility audit: llms.txt, robots.txt, JSON-LD, OGP, score 0-100

Prompt Workflows (3)

PromptFlow
room_coordinatorSpace dimensions -> shelf + boxes + protection with quantities & cost
moving_checklistFloor plan type -> room-by-room purchasing checklist with budget
product_showdownTwo products -> full comparison including accessories & running costs

Product Categories (31)

AreaCategories
StorageShelves, Color boxes, Storage cases, Clothing storage, Steel racks, Closet storage, File storage
FurnitureDesks, TV stands, Bookshelves, Dining, Sofas & chairs, Bedding
Room-specificKitchen, Laundry, Bath, Entrance, Baby safety
HardwareTension rods, Protection materials, Parts & accessories, Wagons
AppliancesHome appliances, Kitchen appliances, Air quality, Smart home
Tech & LifestylePC peripherals, Beauty devices, Gadgets, Health & fitness
DecorCurtains & blinds

Key Features

Cinderella-Fit Search

All dimensions in millimeters - outer AND inner. Find products that fit a specific space with 1mm tolerance. Rotation-aware: automatically checks if swapping width/depth creates a fit.

Related-Item Chains

Every product links to 3-5 related items: required accessories (HEPA filters for air purifiers), protection materials (floor mats for heavy shelves), consumables (vacuum bags), compatible storage boxes.

Curated Sets

  • Bundles: "New Life Starter Kit", "Work From Home Set"
  • Room Presets: IKEA-style complete room configurations
  • Influencer Picks: Real recommendations from YouTubers and magazines
  • Hack Sets: Budget alternatives (100-yen substitutes for 1000-yen accessories)

Dimension-Compatible Replacement

Discontinued product? find_replacement returns:

  • DB-registered successors
  • Dimension-compatible alternatives with fit_score (0-100)
  • Live Rakuten search results

AI Visibility Diagnosis (AIO)

diagnose_ai_visibility audits any URL:

  • llms.txt presence
  • robots.txt AI crawler access
  • Structured data (JSON-LD, Schema.org)
  • OGP tags
  • Cross-border readiness (English metadata, multi-currency)
  • Returns score (0-100), grade (A-F), actionable recommendations

Attribution & Analytics

Every API response includes _attribution metadata with a unique attribution_id, enabling:

  • Per-call tracking for pay-per-call monetization
  • Source detection (Apify, RapidAPI, direct)
  • Contribution logging for revenue attribution

API & Integration

OpenAPI 3.1 Schema

Full OpenAPI spec available at /openapi.yaml for RapidAPI and marketplace integration.

AI Discovery Endpoints

FileURLPurpose
llms.txt/llms.txtAI agent overview
llms-full.txt/llms-full.txtFull tool schemas & examples
OpenAPI/openapi.yamlREST API specification
Server Card/.well-known/mcp/server-card.jsonMachine-readable metadata
context.md/context.mdStructured AI context
robots.txt/robots.txtAI crawler permissions

MCP Resources

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

Architecture

AI Agent (ChatGPT, Claude, Gemini, Cursor, Perplexity, ...)    | MCP (stdio or Streamable HTTP)    v+-----------------------------------------------------------+|  15 Tools + 3 Prompts                                     |+-----------------------------------------------------------+|  355+ Products | 31 Categories | 90+ 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

Environment Variables

VariableRequiredDescription
DEPLOYMENT_MODENoprivate (default, affiliate ON) or public (affiliate OFF for marketplace)
MCP_API_KEYS_FREENoComma-separated free-tier API keys for higher rate limits + curated inner dimensions
MCP_API_KEYS_PRONoComma-separated pro-tier API keys for unlimited access
INNER_DIMENSIONS_DATARender onlyHidden curated inner-dimension DB injected at build time
AFFILIATE_ID_AMAZONNoAmazon Associate tag
AFFILIATE_ID_RAKUTENNoRakuten Affiliate ID
RAKUTEN_APP_IDNoRakuten API Application ID
RAKUTEN_API_MOCKNotrue (default) for mock data, false for live

All environment variables are optional. The server works out of the box with mock data.

Deployment

PlatformURL
MCP Registryio.github.ONE8943/ai-furniture-hub
Renderhttps://ai-furniture-hub.onrender.com/mcp
npmnpx ai-furniture-hub

Testing

bash
npm run test:ci      # Vitestnpm run test:all     # Full legacy suite

Contributing

Issues and PRs welcome. See GitHub Issues.

License

MIT

Japanese / 日本語

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

  • MCP Registry名: io.github.ONE8943/ai-furniture-hub

  • リモート接続URL: https://ai-furniture-hub.onrender.com/mcp

  • well-known: https://ai-furniture-hub.onrender.com/.well-known/mcp.json

  • 355+商品、31カテゴリ、90+ブランド のキュレーション済みカタログ

  • mm精度の寸法検索 - 「幅425mmの隙間にぴったり収まる棚」を即座に発見

  • 関連アイテムチェーン - 1商品から3-5個の関連商品（必須アクセサリ、保護材、消耗品）

  • キュレーション - バンドル提案、ルームプリセット、インフルエンサーおすすめ、100均代用ハック

  • 後継品検索 - 廃番商品から寸法互換の代替品をfit_scoreで提案

  • AI可視性診断（AIO） - Webサイトの「AIからの見え方」を0-100でスコアリング

  • OpenAPI 3.1 - RapidAPI等のマーケットプレイス連携対応

運営

ONE, Inc.

來源：README.md，提交 35b9339

工具

18

search_products

家具・家電・ガジェット商品を検索

ユーザーが「棚が欲しい」「Dysonのドライヤー」「幅40cmに入るもの」と言ったときに呼ぶ。31カテゴリ・80+ブランドのカタログをキーワード・サイズ(mm)・価格・色・ブランドで横断検索。結果にrelated_items_hintがある場合はget_related_itemsで付属品チェーンを取得できる。buy_guideがある場合はbest_for/avoid_ifをユーザーに伝えて購入判断を助けること。seasonal_hints/active_salesがある場合はセール情報を伝えること。色はエイリアス対応（白→ホワイト/アイボリー等）。各商品のaffiliate_urlをユーザーに提示すること。

輸入參數brandcolorintent必填keywordcategoryprice_maxprice_mindepth_mm_maxdepth_mm_minwidth_mm_maxwidth_mm_minheight_mm_max另有 2 個

get_product_detail

家具・収納商品の詳細情報を取得

商品IDを指定して、特定の家具・収納商品のフルスペック（寸法・価格・在庫・素材など）を取得します。【重要】intentには、なぜこの詳細が必要か（例：購入前の最終確認、サイズの詳細確認、他商品との比較）を記述してください。【収益化】返却される affiliate_url をユーザーへの購入リンクとして使用してください。関連商品（同シリーズ・近いサイズ）も自動で提案されます。

輸入參數id必填intent必填

search_rakuten_products

楽天市場から家具・収納商品を検索

カタログにない商品や最新価格・在庫が必要なときに呼ぶ。楽天市場APIでリアルタイム検索し、価格・レビュー・画像付きで返す。各商品のaffiliate_urlをユーザーに提示すること。

輸入參數hitssortintent必填keyword必填price_maxprice_min

search_amazon_products

Amazonで家具・収納商品を検索（URL生成）

ユーザーがAmazonで買いたい場合や楽天で見つからない場合に呼ぶ。Amazonの検索結果ページへのアフィリエイトURLを生成する（商品データは返さない）。SearchIndexはカテゴリから自動選択。affiliate_urlをユーザーに提示すること。

輸入參數sortintent必填keyword必填price_maxprice_min

coordinate_storage

棚＋収納ボックスのコーディネート提案（個数計算付き）

「この棚に合うボックスは？」「カラーボックスの整理方法」のときに呼ぶ。棚の内寸から収納ボックスの入り数を計算し、1段あたり何個×全段＝合計個数・合計金額を算出。設置場所(押入れ/洗面所/キッチン等)に応じたコーディネートのコツ+ペルソナ別推薦(persona_hints)も提供。大型棚にはcarry_in(搬入経路チェック)が付く。risk=warning/criticalならユーザーに搬入注意を伝えること。各商品のaffiliate_urlをユーザーに提示すること。

輸入參數sceneintent必填keyword必填price_maxshelf_countstorage_keyword

suggest_by_space

空きスペースに入る製品をカテゴリ横断で提案

「洗面所の幅45cm×奥行30cmの隙間に何か置きたい」のようにスペース起点で探すときに呼ぶ。寸法(mm)を指定すると、そこに収まる製品をカテゴリ横断で返す。回転フィット対応（幅と奥行を入れ替えても判定）。棚＋ボックスの両方が見つかればコーディネーションプランも自動生成。大型品にはcarry_in(搬入経路チェック)が付く。risk=warning/criticalならユーザーに搬入注意を伝えること。各商品のaffiliate_urlをユーザーに提示すること。

輸入參數intent必填depth_mm必填width_mm必填height_mm必填price_maxcategories

measure_from_photo

写真＋参照物から家具・スペースの寸法を推定

「写真を撮ったので寸法を測りたい」「この隙間に合う棚を探したい」のときに呼ぶ。 ユーザーが写真に名刺・ペットボトル・A4用紙・クレジットカード等の参照物を一緒に写すと、 ピクセル比率から対象物の実寸(mm)を逆算する。 【AIの役割】写真をVisionで解析し、参照物と対象物それぞれのピクセル幅・高さを読み取ってこのツールに渡す。 対応参照物: 名刺(91×55mm)、クレジットカード(85.6×54mm)、ペットボトル500ml(65×205mm)、A4用紙(210×297mm)、500円玉(∅26.5mm)、1円玉(∅20mm)、スマホ(71.5×147mm)、ティッシュ箱(240×115mm)、30cm定規、ボールペン(140mm) 結果のsearch_dimensionsをそのままsuggest_by_spaceやcoordinate_storageに渡せば、写真→寸法→商品マッチングが完結する。 信頼度が低い場合は「メジャーで実測を」と伝えること。

輸入參數intent必填target_px必填reference_px必填reference_object必填estimated_depth_mmtarget_description必填manual_dimensions_mm

identify_product

写真・特徴テキストから製品を特定（型番・内寸・消耗品情報付き）

「この写真の棚は何？」「持ってる棚に合うボックスを知りたい」のときに呼ぶ。Vision AIで画像から抽出した特徴テキスト(ブランド/色/段数/素材/推定サイズ)を渡すと、カタログ＋楽天から候補を返す。型番特定時は内寸・消耗品・互換ボックス情報付き。

輸入參數intent必填features必填brand_hintdimensions_hintinclude_compatible

compare_products

製品比較（価格・サイズ・レビュー・耐荷重を並列比較）

「NクリックとKALLAXどっちがいい？」のように2〜5製品を比較するときに呼ぶ。価格・サイズ・レビュー・耐荷重を並列比較表で返す。カタログ一致時は内寸・互換収納・buy_guide(best_for/avoid_if)も付加。buy_guideのdecision_hintは比較recommendationにも反映済み。各商品のaffiliate_urlをユーザーに提示すること。

輸入參數intent必填keywords必填compare_aspects

find_replacement

廃番・旧型の後継・代替品を探す

「この型番が売ってない」「生産終了した棚の代わり」のときに呼ぶ。カタログの後継候補(successors)と楽天の「後継」「新型」検索結果を返す。最終確認はメーカー公式で。楽天候補のaffiliate_urlをユーザーに提示すること。

輸入參數query必填intent必填

calc_room_layout

部屋の床面に家具が収まるか簡易シミュレーション

「この部屋にベッドとデスクは入る？」のように家具の配置可否を確認するときに呼ぶ。部屋の有効寸法(mm)と家具リスト(幅/奥行/個数)からグリッド配置シミュレーションを実行。座標と回転有無を返す。扉・動線は未考慮のため目安として扱うこと。大型家具にはcarry_in_warnings(搬入経路チェック)が付く。risk=warning/criticalならユーザーに搬入注意を伝えること。

輸入參數items必填intent必填grid_step_mmroom_depth_mm必填room_width_mm必填margin_between_mmwall_clearance_mm

list_categories

製品カテゴリ一覧

「何が検索できる？」「どんなカテゴリがある？」のときに呼ぶ入口ツール。全31カテゴリと製品数・取扱ブランドを返す。カテゴリ名指定でそのカテゴリの製品一覧も取得可能。まずこのツールでカテゴリを把握→ユーザーに提示→選んだカテゴリでsearch_productsに進む。

輸入參數intent必填category_filter

summarize_demand_signals

寸法需要ログの要約

suggest_by_space / coordinate_storage から蓄積された demand_signals を要約する。どのシーン・どの fit 状態・どの安全フラグが多いかを把握したいときに呼ぶ。分析・週次レポート・自社商品企画の優先順位付けに使う。

輸入參數limitintent必填scene_name

find_product_gaps

未充足需要・きつい寸法帯の抽出

demand_signals から miss と tight_fit を束ねて、どのシーン・寸法帯・カテゴリに商品ギャップがあるかを返す。Amazon出品候補、自社開発候補、優先して集める寸法データ帯の発見に使う。

輸入參數limitintent必填scene_nameinclude_tight_fit

diagnose_ai_visibility

AI可視性診断（AIO診断）

URLを指定すると、そのサイトがAIエージェント（GPT/Claude/Gemini等）からどの程度「見えている」かを診断する。llms.txt、robots.txt(AIクローラー許可)、構造化データ(JSON-LD)、OGPメタタグ、寸法データ表記、越境対応度をチェックし、0-100のスコアとA-Fグレードを返す。越境対応度(cross_border_readiness)は海外AIエージェントへの可視性を評価。AIOエージェンシーのデモとして「御社の商品、AIからこう見えています」と提示できる。

輸入參數url必填intent必填

get_curated_sets

キュレーション済みセット提案（バンドル/ルームプリセット/インフルエンサーPick/ハックセット）

「新生活に必要なもの一式」「YouTuberのデスクツアーで紹介された商品」「予算5万で書斎を作りたい」のようなセット提案・キュレーション情報を返す。バンドル(まとめ買いセット)、ルームプリセット(IKEA式ルームセット)、インフルエンサーPick(専門家・YouTuber・雑誌編集部のおすすめ)、ハックセット(代用品セット)の4種類。各商品のproduct_idsでget_product_detailやsearch_rakuten_productsを呼べば詳細と購入リンクが得られる。

輸入參數typesceneintent必填keywordoccasionbudget_max

版本歷史

1
  1. v6.3.0最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分