io.github.ONE8943/ai-furniture-hub icon

AI Furniture & Home Product Hub

by ONE8943

io.github.ONE8943/ai-furniture-hub

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

Version 6.3.0
AI Tools
Remote (HTTP)
View source

AI Furniture & Home Product Hub · v6.3.0

by ONE8943

49

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

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:

{
  "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)

npx ai-furniture-hub

Option 3: Clone & Run

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

Tools (15)

Search & Discovery

Tool What It Does
search_products Search 300+ products by keyword, dimensions (mm), price, color, category, brand
get_product_detail Full specs: inner dimensions, consumables, compatible storage, curations
search_rakuten_products Real-time Rakuten Ichiba search (200K+ listings with prices & reviews)
search_amazon_products Amazon affiliate search URL generation with auto SearchIndex
suggest_by_space "I have a 600x400mm space" -> everything that fits, rotation-aware
identify_product Visual description -> product candidates with model numbers

Coordination & Comparison

Tool What It Does
coordinate_storage Shelf + storage box set proposals: quantity per tier, total cost
compare_products Side-by-side comparison (2-5 products) on price, size, load, reviews
find_replacement Discontinued model -> successors + dimension-compatible alternatives with fit_score
calc_room_layout Floor-plan rectangle packing with placement coordinates
get_related_items Accessory chains: required items, protection, consumables, hack substitutes (depth 1-2)

Curation & Intelligence

Tool What It Does
get_curated_sets Bundles, room presets, influencer picks, hack sets. Filter by type/scene/budget
get_popular_products Trending products by category with Rakuten data
list_categories Browse 31 categories with counts, brands, samples
diagnose_ai_visibility AI visibility audit: llms.txt, robots.txt, JSON-LD, OGP, score 0-100

Prompt Workflows (3)

Prompt Flow
room_coordinator Space dimensions -> shelf + boxes + protection with quantities & cost
moving_checklist Floor plan type -> room-by-room purchasing checklist with budget
product_showdown Two products -> full comparison including accessories & running costs

Product Categories (31)

Area Categories
Storage Shelves, Color boxes, Storage cases, Clothing storage, Steel racks, Closet storage, File storage
Furniture Desks, TV stands, Bookshelves, Dining, Sofas & chairs, Bedding
Room-specific Kitchen, Laundry, Bath, Entrance, Baby safety
Hardware Tension rods, Protection materials, Parts & accessories, Wagons
Appliances Home appliances, Kitchen appliances, Air quality, Smart home
Tech & Lifestyle PC peripherals, Beauty devices, Gadgets, Health & fitness
Decor Curtains & 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

File URL Purpose
llms.txt /llms.txt AI agent overview
llms-full.txt /llms-full.txt Full tool schemas & examples
OpenAPI /openapi.yaml REST API specification
Server Card /.well-known/mcp/server-card.json Machine-readable metadata
context.md /context.md Structured AI context
robots.txt /robots.txt AI crawler permissions

MCP Resources

furniture-hub://llms.txt
furniture-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

Variable Required Description
DEPLOYMENT_MODE No private (default, affiliate ON) or public (affiliate OFF for marketplace)
MCP_API_KEYS_FREE No Comma-separated free-tier API keys for higher rate limits + curated inner dimensions
MCP_API_KEYS_PRO No Comma-separated pro-tier API keys for unlimited access
INNER_DIMENSIONS_DATA Render only Hidden curated inner-dimension DB injected at build time
AFFILIATE_ID_AMAZON No Amazon Associate tag
AFFILIATE_ID_RAKUTEN No Rakuten Affiliate ID
RAKUTEN_APP_ID No Rakuten API Application ID
RAKUTEN_API_MOCK No true (default) for mock data, false for live

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

Deployment

Platform URL
MCP Registry io.github.ONE8943/ai-furniture-hub
Render https://ai-furniture-hub.onrender.com/mcp
npm npx ai-furniture-hub

Testing

npm run test:ci      # Vitest
npm 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.