ONE8943/ai-furniture-hub

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:

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