AI HomeDesign MCP
MCP server to virtually stage, redesign, enhance and declutter real-estate photos.
我該用這個嗎
品質與安全性
發現項目（4）
- LOWTool 'interior_design' description lacks action verb在 interior_design 中
- LOWTool 'change_wall' description lacks action verb在 change_wall 中
- LOWTool 'change_floor' description lacks action verb在 change_floor 中
- LOWTool 'change_ceiling' description lacks action verb在 change_ceiling 中
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"aihomedesign-mcp": {
"url": "https://mcp.aihomedesign.com/{connector_token}/mcp"
}
}
}遠端端點
https://mcp.aihomedesign.com/{connector_token}/mcpstreamable-http它能做什麼
工具清單
工具（20）
🟢list_capabilities
List every AI HomeDesign tool this MCP can run, grouped by category. Returns each tool's slug, display name, description and whether it needs one or two input images. Start here to discover what is available.
輸入結構描述
{
"type": "object",
"properties": {},
"title": "list_capabilitiesArguments"
}🟢list_styles(tool_slug)
List the allowed design styles, room types and widget options. With no argument, returns the global style/room/area lists. With a tool_slug, returns that tool's widgets and their allowed values. The staging/design helpers ONLY accept these values — anything else is rejected before calling the API.
輸入結構描述
{
"type": "object",
"properties": {
"tool_slug": {
"default": "",
"title": "Tool Slug",
"type": "string"
}
},
"title": "list_stylesArguments"
}🟢describe_tool(tool_slug)
Show the input slots, widgets and selectable options for one tool, plus a ready-to-use example payload for `run_process`. Use this before `run_process` when you need the exact widget/item slugs for a tool.
輸入結構描述
{
"type": "object",
"properties": {
"tool_slug": {
"title": "Tool Slug",
"type": "string"
}
},
"required": [
"tool_slug"
],
"title": "describe_toolArguments"
}🟡create_project(address)
Create a project (a container that groups all work for one property). Returns the new project's `id`.
輸入結構描述
{
"type": "object",
"properties": {
"address": {
"title": "Address",
"type": "string"
}
},
"required": [
"address"
],
"title": "create_projectArguments"
}🟢list_projects(page, limit, search)
List your projects (paginated). Optional free-text `search` on address.
輸入結構描述
{
"type": "object",
"properties": {
"page": {
"default": 1,
"title": "Page",
"type": "integer"
},
"limit": {
"default": 10,
"title": "Limit",
"type": "integer"
},
"search": {
"default": "",
"title": "Search",
"type": "string"
}
},
"title": "list_projectsArguments"
}🟢get_project(project_id)
Fetch a single project by id.
輸入結構描述
{
"type": "object",
"properties": {
"project_id": {
"title": "Project Id",
"type": "string"
}
},
"required": [
"project_id"
],
"title": "get_projectArguments"
}🟡create_order(image_urls, image_base64, project_id, asset_roles)
Upload one or more images and create an order. Provide `image_urls` (public URLs) and/or `image_base64` (raw base64 or data: URLs) — you can use either. Returns `order_id` and an `assets` list whose `id`s you map to a tool's input slot when running a process. For two-image tools pass roles like ['primary_angle','secondary_angle'] (or 'mask' for mask tools).
輸入結構描述
{
"type": "object",
"properties": {
"image_urls": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Image Urls"
},
"image_base64": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Image Base64"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
},
"asset_roles": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Asset Roles"
}
},
"title": "create_orderArguments"
}🟢get_order(order_id)
Fetch an order, including its input assets and any processes run on it.
輸入結構描述
{
"type": "object",
"properties": {
"order_id": {
"title": "Order Id",
"type": "string"
}
},
"required": [
"order_id"
],
"title": "get_orderArguments"
}🟢run_process(order_id, tool, asset_map, widgets, process_group_id)
Start an AI job on an existing order (full control over every tool). `asset_map` maps each of the tool's input-slot keys to an asset id from the order. `widgets` is the raw list of {slug, item_slugs}. Use `describe_tool` to get the exact slugs. Returns `process_ids` to poll with `get_process`.
輸入結構描述
{
"type": "object",
"properties": {
"order_id": {
"title": "Order Id",
"type": "string"
},
"tool": {
"title": "Tool",
"type": "string"
},
"asset_map": {
"additionalProperties": true,
"title": "Asset Map",
"type": "object"
},
"widgets": {
"anyOf": [
{
"items": {},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Widgets"
},
"process_group_id": {
"default": "",
"title": "Process Group Id",
"type": "string"
}
},
"required": [
"order_id",
"tool",
"asset_map"
],
"title": "run_processArguments"
}🟢get_process(process_id)
Fetch a process: its `status` (pending/processing/done/failed) and, when done, the `final_assets` with downloadable result image URLs. If a webhook result has already arrived for this process, it is returned immediately.
輸入結構描述
{
"type": "object",
"properties": {
"process_id": {
"title": "Process Id",
"type": "string"
}
},
"required": [
"process_id"
],
"title": "get_processArguments"
}⚪wait_for_result(process_id, timeout_seconds, poll_seconds)
Poll a process until it is `done` or `failed` (or until timeout), then return the final result image URLs. Respects the API's 5s minimum poll interval.
輸入結構描述
{
"type": "object",
"properties": {
"process_id": {
"title": "Process Id",
"type": "string"
},
"timeout_seconds": {
"default": 180,
"title": "Timeout Seconds",
"type": "integer"
},
"poll_seconds": {
"default": 6,
"title": "Poll Seconds",
"type": "integer"
}
},
"required": [
"process_id"
],
"title": "wait_for_resultArguments"
}🟢virtual_staging(image_url, style, space, image_base64, wait, ...)
Furnish an EMPTY room photo with AI furniture in a chosen design style. Provide the photo as `image_url` OR `image_base64` (raw base64 or a data: URL). WORKFLOW — follow exactly: • Do NOT choose a `style` yourself. Call this first with style empty; it returns the list of design styles. Present them to the user and let THEM pick, then call again with their chosen style. • Detect `space` (room type) from the image yourself and pass it (bedroom, kitchen, living-room, ...). Only if you truly cannot tell, leave it empty and the tool will ask the user.
輸入結構描述
{
"type": "object",
"properties": {
"image_url": {
"default": "",
"title": "Image Url",
"type": "string"
},
"style": {
"default": "",
"title": "Style",
"type": "string"
},
"space": {
"default": "",
"title": "Space",
"type": "string"
},
"image_base64": {
"default": "",
"title": "Image Base64",
"type": "string"
},
"wait": {
"default": true,
"title": "Wait",
"type": "boolean"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
}
},
"title": "virtual_stagingArguments"
}⚪interior_design(image_url, style, space, image_base64, wait, ...)
Fully redesign a FURNISHED room (walls, floors, furniture, decor) in a style. Same workflow as virtual_staging: never pick the style yourself — ask the user; detect the room type from the image. Provide image_url OR image_base64.
輸入結構描述
{
"type": "object",
"properties": {
"image_url": {
"default": "",
"title": "Image Url",
"type": "string"
},
"style": {
"default": "",
"title": "Style",
"type": "string"
},
"space": {
"default": "",
"title": "Space",
"type": "string"
},
"image_base64": {
"default": "",
"title": "Image Base64",
"type": "string"
},
"wait": {
"default": true,
"title": "Wait",
"type": "boolean"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
}
},
"title": "interior_designArguments"
}⚪virtual_restaging(image_url, style, space, image_base64, wait, ...)
Replace the furniture in an ALREADY-FURNISHED room with a new design style. Same workflow as virtual_staging: ask the user for the style, detect the room type from the image. Provide image_url OR image_base64.
輸入結構描述
{
"type": "object",
"properties": {
"image_url": {
"default": "",
"title": "Image Url",
"type": "string"
},
"style": {
"default": "",
"title": "Style",
"type": "string"
},
"space": {
"default": "",
"title": "Space",
"type": "string"
},
"image_base64": {
"default": "",
"title": "Image Base64",
"type": "string"
},
"wait": {
"default": true,
"title": "Wait",
"type": "boolean"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
}
},
"title": "virtual_restagingArguments"
}🟡enhance_image(image_url, area, options, image_base64, wait, ...)
Enhance a photo: better lighting, sharpness and colour balance. No style needed. Provide image_url OR image_base64. area: indoor | outdoor (detect from the image). options (multi, optional): add-fire-to-fireplace, add-screen-to-tv.
輸入結構描述
{
"type": "object",
"properties": {
"image_url": {
"default": "",
"title": "Image Url",
"type": "string"
},
"area": {
"default": "indoor",
"title": "Area",
"type": "string"
},
"options": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Options"
},
"image_base64": {
"default": "",
"title": "Image Base64",
"type": "string"
},
"wait": {
"default": true,
"title": "Wait",
"type": "boolean"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
}
},
"title": "enhance_imageArguments"
}🔴remove_items(image_url, image_base64, wait, project_id)
Auto-detect and remove furniture/clutter from a room photo (decluttering), leaving a clean empty space. No style needed. Provide image_url OR image_base64.
輸入結構描述
{
"type": "object",
"properties": {
"image_url": {
"default": "",
"title": "Image Url",
"type": "string"
},
"image_base64": {
"default": "",
"title": "Image Base64",
"type": "string"
},
"wait": {
"default": true,
"title": "Wait",
"type": "boolean"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
}
},
"title": "remove_itemsArguments"
}⚪day_to_dusk(image_url, sky_style, options, image_base64, wait, ...)
Convert a daytime EXTERIOR photo into a dusk / twilight scene. No style needed. Provide image_url OR image_base64. sky_style: leave empty to use the default sky (recommended — the 30+ named sky slugs are not publicly listed). options (multi, optional): shadow-removal, lawn-touch-up.
輸入結構描述
{
"type": "object",
"properties": {
"image_url": {
"default": "",
"title": "Image Url",
"type": "string"
},
"sky_style": {
"default": "",
"title": "Sky Style",
"type": "string"
},
"options": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Options"
},
"image_base64": {
"default": "",
"title": "Image Base64",
"type": "string"
},
"wait": {
"default": true,
"title": "Wait",
"type": "boolean"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
}
},
"title": "day_to_duskArguments"
}🟡change_wall(image_url, space, image_base64, wait, project_id)
Change the wall finish/colour in a room photo (AI applies a tasteful default finish). Detect `space` (room type) from the image. Provide image_url OR image_base64.
輸入結構描述
{
"type": "object",
"properties": {
"image_url": {
"default": "",
"title": "Image Url",
"type": "string"
},
"space": {
"default": "",
"title": "Space",
"type": "string"
},
"image_base64": {
"default": "",
"title": "Image Base64",
"type": "string"
},
"wait": {
"default": true,
"title": "Wait",
"type": "boolean"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
}
},
"title": "change_wallArguments"
}🟡change_floor(image_url, space, image_base64, wait, project_id)
Change the floor material in a room photo (AI applies a tasteful default material). Detect `space` from the image. Provide image_url OR image_base64.
輸入結構描述
{
"type": "object",
"properties": {
"image_url": {
"default": "",
"title": "Image Url",
"type": "string"
},
"space": {
"default": "",
"title": "Space",
"type": "string"
},
"image_base64": {
"default": "",
"title": "Image Base64",
"type": "string"
},
"wait": {
"default": true,
"title": "Wait",
"type": "boolean"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
}
},
"title": "change_floorArguments"
}🟡change_ceiling(image_url, space, image_base64, wait, project_id)
Change the ceiling finish in a room photo (AI applies a tasteful default). Detect `space` from the image. Provide image_url OR image_base64.
輸入結構描述
{
"type": "object",
"properties": {
"image_url": {
"default": "",
"title": "Image Url",
"type": "string"
},
"space": {
"default": "",
"title": "Space",
"type": "string"
},
"image_base64": {
"default": "",
"title": "Image Base64",
"type": "string"
},
"wait": {
"default": true,
"title": "Wait",
"type": "boolean"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
}
},
"title": "change_ceilingArguments"
}社群
證據