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)

区域	类别
收纳	货架、彩色收纳盒、收纳箱、衣物收纳、钢制架、壁橱收纳、文件收纳
家具	书桌、电视柜、书架、餐厅家具、沙发与椅子、寝具
房间专用	厨房、洗衣房、浴室、玄关、婴儿安全
五金	伸缩杆、保护材料、零件与配件、推车
家电	家用电器、厨房电器、空气质量、智能家居
科技与生活	PC外设、美容设备、小工具、健康与健身
装饰	窗帘与百叶窗

核心功能

灰姑娘式精准搜索

所有尺寸均以毫米为单位 - 包括外部和内部。以1mm的公差找到适合特定空间的产品。支持旋转感知：自动检查交换宽度/深度是否能匹配。

关联商品链

每个产品都链接到3-5个相关项目：必需配件（空气净化器的HEPA滤网）、保护材料（重型货架的地垫）、耗材（吸尘器袋）、兼容收纳盒。

精选套装

捆绑包：“新生活入门套件”、“居家办公套装”
房间预设：宜家风格的完整房间配置
网红推荐：来自YouTuber和杂志的真实推荐
黑客套装：预算替代方案（用100日元替代品代替1000日元的配件）

尺寸兼容的替代品

产品停产了？find_replacement 返回：

数据库注册的后续产品
带有 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 架构

完整的OpenAPI规范可在 /openapi.yaml 获取，用于RapidAPI和市场集成。

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` (默认，开启联盟) 或 `public` (关闭联盟，用于市场)
`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

贡献

欢迎提交Issue和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