YourSpaceLab MCP Server

This MCP Server exposes YourSpaceLab's AI Virtual Staging capabilities to AI agents (like Claude, OpenClaw, etc.).

It implements a "Sync-over-Async" pattern: when an agent requests a staging job, the server handles the asynchronous polling internally and returns the final result only when the image is ready.

Features

• Virtual Staging: Transform empty room photos (ysl_stage_room)
• Defurnishing: Remove existing furniture (ysl_defurnish_room)
• Credit Check: Check remaining credits (ysl_check_credits)

Setup

Prerequisites

• Node.js v18+
• An API Key from YourSpaceLab (Ask admin or generate one in DB)

Installation

1. Clone the repository and navigate to mcp-server:

   cd mcp-server
   npm install

2. Configure Environment:

   cp .env.example .env
   # Edit .env and set YSL_API_KEY=ysl_live_...

3. Build:

   npm run build

Usage with Claude Desktop / Cursor

Add the following to your MCP configuration file (e.g., ~/AppData/Roaming/Claude/claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "yourspacelab": {
      "command": "node",
      "args": [
        "C:/path/to/your/repo/mcp-server/build/index.js"
      ],
      "env": {
        "YSL_API_KEY": "ysl_live_xxxxx"
      }
    }
  }
}

Development

npm run dev