Skip to main content
Glama
ONE8943

ai-furniture-hub

by ONE8943
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid
README.md
# 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](https://github.com/ONE8943/ai-furniture-hub/actions/workflows/ci.yml/badge.svg)](https://github.com/ONE8943/ai-furniture-hub/actions/workflows/ci.yml)
[![npm](https://img.shields.io/npm/v/ai-furniture-hub)](https://www.npmjs.com/package/ai-furniture-hub)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/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`](https://www.npmjs.com/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.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`](https://ai-furniture-hub.onrender.com/openapi.yaml) for RapidAPI and marketplace integration.

### AI Discovery Endpoints

| File | URL | Purpose |
|------|-----|---------|
| llms.txt | [/llms.txt](https://ai-furniture-hub.onrender.com/llms.txt) | AI agent overview |
| llms-full.txt | [/llms-full.txt](https://ai-furniture-hub.onrender.com/llms-full.txt) | Full tool schemas & examples |
| OpenAPI | [/openapi.yaml](https://ai-furniture-hub.onrender.com/openapi.yaml) | REST API specification |
| Server Card | [/.well-known/mcp/server-card.json](https://ai-furniture-hub.onrender.com/.well-known/mcp/server-card.json) | Machine-readable metadata |
| context.md | [/context.md](https://ai-furniture-hub.onrender.com/context.md) | Structured AI context |
| robots.txt | [/robots.txt](https://ai-furniture-hub.onrender.com/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

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

## Contributing

Issues and PRs welcome. See [GitHub Issues](https://github.com/ONE8943/ai-furniture-hub/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.
Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4/5.0

Scored across 15 tools

Disambiguation3/5

The tools have distinct primary purposes, but there is notable overlap in search and recommendation functions. For example, search_products, search_rakuten_products, and search_amazon_products all handle product searches across different platforms, while get_popular_products and get_curated_sets both provide recommendations, which could cause confusion in tool selection. Descriptions help clarify, but the boundaries are not always sharp.

Naming Consistency4/5

Most tools follow a consistent verb_noun naming pattern (e.g., calc_room_layout, compare_products, get_product_detail), which aids predictability. However, there are minor deviations like diagnose_ai_visibility and identify_product, which use different verb styles or compound terms, slightly breaking the pattern but remaining readable overall.

Tool Count5/5

With 15 tools, the server is well-scoped for its furniture and home goods domain, covering aspects like layout calculation, product search, comparison, recommendations, and diagnostics. Each tool appears to serve a specific function without redundancy, making the count appropriate for the intended purpose.

Completeness4/5

The toolset provides comprehensive coverage for furniture and home goods, including search, comparison, recommendations, layout planning, and product identification. Minor gaps exist, such as no explicit tools for user account management or order tracking, but these are not core to the domain, and agents can work around them with the available tools.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources