内容
# AI 家具与家居产品中心 - MCP 服务器
> **15 个工具** | **355+ 个精选产品** | **31 个类别** | **90+ 个品牌**
> 毫米级精确搜索，精选集合，AI 可视性诊断，OpenAPI 3.1 架构。
> 为 ChatGPT、Claude、Gemini、Cursor、Perplexity 及任何与 MCP 兼容的 AI 代理而建。
[](https://github.com/ONE8943/ai-furniture-hub/actions/workflows/ci.yml)
[](https://www.npmjs.com/package/ai-furniture-hub)
[](https://opensource.org/licenses/MIT)
## 发现与安装
- **MCP 注册名称**: `io.github.ONE8943/ai-furniture-hub`
- **远程 MCP 端点**: `https://ai-furniture-hub.onrender.com/mcp`
- **知名发现**: `https://ai-furniture-hub.onrender.com/.well-known/mcp.json`
- **npm 包**: [`ai-furniture-hub`](https://www.npmjs.com/package/ai-furniture-hub)
如果您的 MCP 客户端支持注册搜索，请搜索 `io.github.ONE8943/ai-furniture-hub` 或 `AI Furniture & Home Product Hub`。
如果您的客户端支持直接远程 MCP，请将其连接到 `https://ai-furniture-hub.onrender.com/mcp`。
## 为什么存在
AI 代理需要结构化、机器优化的产品数据才能提供有用的推荐。此 MCP 服务器提供：
- **精确搜索**: “找到一个适合 425mm 间隙的架子” 返回产品，精度为 1mm
- **完整解决方案**: 一次搜索返回架子 + 匹配的储物盒 + 地板保护 + 电缆整理
- **专家精选**: 影响者精选，房间预设，捆绑交易和预算黑客替代品
- **替代智能**: 停产产品？获取具有维度兼容性的后续产品（兼容度评分 0-100）
- **AI 可视性咨询**: 诊断任何网站的 AI 可发现性，只需一次工具调用
## 快速入门
### 选项 1：远程（Cursor / Claude / VS Code / ChatGPT）
直接连接到托管服务器：
```json
{
"mcpServers": {
"furniture-hub": {
"url": "https://ai-furniture-hub.onrender.com/mcp"
}
}
}
```
适用于任何接受远程流式 HTTP URL 的 MCP 客户端。
### 选项 2：npx（本地）
```bash
npx ai-furniture-hub
```
### 选项 3：克隆与运行
```bash
git clone https://github.com/ONE8943/ai-furniture-hub.git
cd ai-furniture-hub
npm install
cp .env.example .env # API 密钥可选 - 适用于模拟数据
npm start # 标准输入/输出模式
npm run start:http # HTTP 模式，监听 localhost:3000/mcp
```
## 工具（15 个）
### 搜索与发现
| 工具 | 功能 |
|------|-------------|
| `search_products` | 按关键词、尺寸（毫米）、价格、颜色、类别、品牌搜索 300+ 产品 |
| `get_product_detail` | 完整规格：内尺寸、耗材、兼容存储、精选 |
| `search_rakuten_products` | 实时 Rakuten Ichiba 搜索（200K+ 商品，含价格和评论） |
| `search_amazon_products` | Amazon 联盟搜索 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` | 按类别列出的热门产品，附 Rakuten 数据 |
| `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 个相关物品：所需配件（空气净化器滤芯）、保护材料（重型架子地板垫）、耗材（真空袋）、兼容存储箱。
### 精选集合
- **捆绑**: “新生活入门套件”，“在家工作套件”
- **房间预设**: IKEA 风格的完整房间配置
- **影响者精选**: 来自 YouTuber 和杂志的真实推荐
- **黑客集合**: 经济替代品（100 日元替代 1000 日元配件）
### 尺寸兼容替代
停产产品？`find_replacement` 返回：
- 数据库注册的后续产品
- 具有 `fit_score` 的尺寸兼容替代品（0-100）
- 实时 Rakuten 搜索结果
### 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`](https://ai-furniture-hub.onrender.com/openapi.yaml) 中找到，用于 RapidAPI 和市场集成。
### AI 发现端点
| 文件 | URL | 目的 |
|------|-----|---------|
| llms.txt | [/llms.txt](https://ai-furniture-hub.onrender.com/llms.txt) | AI 代理概述 |
| llms-full.txt | [/llms-full.txt](https://ai-furniture-hub.onrender.com/llms-full.txt) | 完整工具架构和示例 |
| OpenAPI | [/openapi.yaml](https://ai-furniture-hub.onrender.com/openapi.yaml) | REST API 规范 |
| 服务器卡 | [/.well-known/mcp/server-card.json](https://ai-furniture-hub.onrender.com/.well-known/mcp/server-card.json) | 机器可读元数据 |
| context.md | [/context.md](https://ai-furniture-hub.onrender.com/context.md) | 结构化 AI 上下文 |
| robots.txt | [/robots.txt](https://ai-furniture-hub.onrender.com/robots.txt) | AI 爬虫权限 |
### MCP 资源
```
furniture-hub://llms.txt
furniture-hub://llms-full.txt
```
## 架构
```
AI 代理（ChatGPT，Claude，Gemini，Cursor，Perplexity，...）
| MCP（标准输入/输出或流式 HTTP）
v
+-----------------------------------------------------------+
| 15 个工具 + 3 个提示 |
+-----------------------------------------------------------+
| 355+ 产品 | 31 个类别 | 90+ 品牌 |
| 精选集合：捆绑，房间预设，影响者精选 |
| 兼容性数据库：基于尺寸的适配评分 |
| 属性：每个请求的跟踪，附带 attribution_id |
+-----------------------------------------------------------+
| 适配器：Rakuten API / Amazon URL / Nitori |
| 联盟引擎 + 差距检测器 + 分析工具 |
+-----------------------------------------------------------+
|
v
/llms.txt /llms-full.txt /openapi.yaml
/context.md /.well-known/mcp/ /robots.txt
```
## 环境变量
| 变量 | 是否必需 | 描述 |
|----------|----------|-------------|
| `DEPLOYMENT_MODE` | 否 | `private`（默认，联盟功能开启）或 `public`（联盟功能关闭，适用于市场） |
| `MCP_API_KEYS_FREE` | 否 | 逗号分隔的免费 API 密钥，用于提高速率限制和精选内部尺寸 |
| `MCP_API_KEYS_PRO` | 否 | 逗号分隔的高级 API 密钥，用于无限访问 |
| `INNER_DIMENSIONS_DATA` | 仅渲染 | 在构建时注入的隐藏精选内部尺寸数据库 |
| `AFFILIATE_ID_AMAZON` | 否 | Amazon 合作伙伴标签 |
| `AFFILIATE_ID_RAKUTEN` | 否 | Rakuten 合作伙伴 ID |
| `RAKUTEN_APP_ID` | 否 | Rakuten API 应用程序 ID |
| `RAKUTEN_API_MOCK` | 否 | `true`（默认）模拟数据，`false` 真实数据 |
所有环境变量均为可选。服务器使用模拟数据开箱即用。
## 部署
| 平台 | URL |
|----------|-----|
| **MCP 注册** | `io.github.ONE8943/ai-furniture-hub` |
| **Render** | `https://ai-furniture-hub.onrender.com/mcp` |
| **npm** | `npx ai-furniture-hub` |
## 测试
```bash
npm run test:ci # Vitest
npm run test:all # 完整旧版测试套件
```
## 贡献
欢迎提出问题和 PR。请参阅 [GitHub 问题](https://github.com/ONE8943/ai-furniture-hub/issues)。
## 许可证
MIT
---
## 日语 /
**AI 家具与家居产品中心** 是针对 AI 代理的家具、家电和小工具的 MCP 服务器。
- **MCP 注册名称**: `io.github.ONE8943/ai-furniture-hub`
- **远程连接 URL**: `https://ai-furniture-hub.onrender.com/mcp`
- **知名发现**: `https://ai-furniture-hub.onrender.com/.well-known/mcp.json`
- **355+ 产品，31 个类别，90+ 品牌** 的精选目录
- **毫米级精确搜索** - 立即找到“适合 425mm 间隙的架子”
- **相关物品链** - 1 个产品到 3-5 个相关物品（必需配件，保护材料，耗材）
- **精选** - 捆绑建议，房间预设，影响者推荐，100 日元替代黑客
- **后续产品搜索** - 从停产产品到尺寸兼容的替代品，fit_score 推荐
- **AI 可视性诊断（AIO）** - 网站的“AI 可见性”评分为 0-100
- **OpenAPI 3.1** - RapidAPI 等市场集成
### 运营
ONE 株式会社
