AI 가구 및 홈 제품 허브 - MCP 서버

15개 도구 | 300개 이상의 엄선된 제품 | 31개 카테고리 | 80개 이상의 브랜드 밀리미터 단위 정밀 검색, 큐레이션 세트, AI 가시성 진단, OpenAPI 3.1 스키마 제공. ChatGPT, Claude, Gemini, Cursor, Perplexity 및 모든 MCP 호환 AI 에이전트를 위해 구축되었습니다.

npm License: MIT

이 프로젝트의 목적

AI 에이전트가 유용한 추천을 하려면 구조화되고 기계에 최적화된 제품 데이터가 필요합니다. 이 MCP 서버는 다음을 제공합니다:

정밀 맞춤 검색: "425mm 틈새에 맞는 선반 찾기" 요청 시 1mm 오차 범위 내의 제품을 반환
완벽한 솔루션: 한 번의 검색으로 선반 + 어울리는 수납 박스 + 바닥 보호재 + 케이블 정리 도구까지 제안
전문가 큐레이션: 인플루언서 추천, 룸 프리셋, 번들 상품, 가성비 대체품 제안
대체품 지능: 단종된 제품인가요? 치수 호환성(fit_score 0-100)에 따라 순위가 매겨진 후속 제품을 확인하세요
AI 가시성 컨설팅: 단일 도구 호출로 모든 웹사이트의 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가 포함된 아마존 제휴 검색 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`	두 제품 -> 액세서리 및 유지 비용을 포함한 전체 비교

제품 카테고리 (31)

영역	카테고리
수납	선반, 컬러 박스, 수납 케이스, 의류 수납, 스틸 랙, 옷장 수납, 파일 수납
가구	책상, TV 스탠드, 책장, 다이닝, 소파 및 의자, 침구
공간별	주방, 세탁실, 욕실, 현관, 유아 안전
하드웨어	압축봉, 보호재, 부품 및 액세서리, 웨건
가전	생활 가전, 주방 가전, 공기질 관리, 스마트 홈
기술 및 라이프스타일	PC 주변기기, 뷰티 기기, 가젯, 건강 및 피트니스
인테리어	커튼 및 블라인드

주요 기능

신데렐라 핏 검색

모든 치수는 밀리미터 단위(외부 및 내부)입니다. 1mm 오차 범위 내에서 특정 공간에 맞는 제품을 찾습니다. 회전 인식 기능: 가로/세로를 바꾸었을 때 맞는지 자동으로 확인합니다.

큐레이션 세트

번들: "새로운 생활 시작 키트", "재택근무 세트"
룸 프리셋: 이케아 스타일의 완벽한 방 구성
인플루언서 추천: 유튜버와 잡지에서 검증된 실제 추천 제품
해킹 세트: 가성비 대체품 (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 사양은 /openapi.yaml에서 확인할 수 있습니다.

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`	아니오	아마존 어소시에이트 태그
`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

기여

이슈 및 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