@lunaar/mcp-server

Model Context Protocol server for the Lunaar Public API. Lets Claude, Cursor, Windsurf and any other MCP-compatible host use Lunaar's AI building blocks — sketch-to-render, virtual try-on, jewelry / glasses compositing, body measurement extraction, image-to-3D, AR viewer publishing, upscaling — as native tools, all called by name from chat.

Quick install

You'll need an API key. Sign up at platform.lunaarvision.com → API Keys → New key and copy the lk_live_… value once.

Claude Desktop / Claude Code

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) — or the equivalent on Windows / Linux:

{
  "mcpServers": {
    "lunaar": {
      "command": "npx",
      "args": ["-y", "@lunaar/mcp-server"],
      "env": {
        "LUNAAR_API_KEY": "lk_live_REPLACE_ME"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json (or Settings → Features → Model Context Protocol):

{
  "mcpServers": {
    "lunaar": {
      "command": "npx",
      "args": ["-y", "@lunaar/mcp-server"],
      "env": { "LUNAAR_API_KEY": "lk_live_REPLACE_ME" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "lunaar": {
      "command": "npx",
      "args": ["-y", "@lunaar/mcp-server"],
      "env": { "LUNAAR_API_KEY": "lk_live_REPLACE_ME" }
    }
  }
}

Restart the host after editing config. The Lunaar tools should appear in the tool picker / /mcp list.

Tools exposed

How long-running operations are handled

Most calls reach Completed within 30-90 seconds and the tool returns the final asset URL inline. For Image-to-3D (~3 minutes) the wrapper polls up to 4 minutes; if the host's tool-execution budget is shorter and the operation hasn't finished, the tool returns the operationId and the model can call lunaar_get_operation to pick the result up later.

Failed runs surface the user-friendly error message (Turkish, by design — same string Lunaar's product UI shows end users) and the credit refund total.

Configuration

Development

git clone https://github.com/Group-Taiga/lunaar-mcp-server.git
cd lunaar-mcp-server
npm install
npm run build
LUNAAR_API_KEY=lk_live_... node dist/index.js

npm run dev re-compiles on save. To test the binary against an MCP host locally, point the host config at the absolute path of the built dist/index.js.

License

MIT — see LICENSE.