Frequently Asked Questions about HeyBeauty MCP Server

Q: What is an MCP Server? A: MCP (Model Context Protocol) server acts as a bridge, allowing AI models to access and interact with external data sources and tools. MCP is an open protocol that standardizes how applications provide context to LLMs.

Q: What is the HeyBeauty MCP Server? A: The HeyBeauty MCP Server is a TypeScript-based implementation of an MCP server designed for virtual try-on applications, using the HeyBeauty API.

Q: What is UBOS? A: UBOS is a full-stack AI Agent Development Platform focused on helping businesses orchestrate AI Agents, connect them with enterprise data, and build custom AI Agents with their own LLM models and Multi-Agent Systems.

Q: How do I get a HeyBeauty API Key? A: You can apply for a HeyBeauty API Key at https://heybeauty.com/docs/api/introduction.

Q: How do I install the HeyBeauty MCP Server? A: To install the server, add the server config to your MCP Client config file (e.g., claude_desktop_config.json). You’ll need to specify the command to run the server, arguments, and the HEYBEAUTY_API_KEY environment variable.

Q: What are the key features of the HeyBeauty MCP Server? A: Key features include cloth resources with URIs and metadata, tools for submitting and querying try-on tasks (submit_tryon_task, query_tryon_task), and prompts for LLM try-on (tryon_cloth).

Q: What are the resources provided by the server? A: The server provides cloth:// URIs for accessing clothes, each with an ID, name, description, image URL, and metadata.

Q: How do I submit a try-on task? A: Use the submit_tryon_task tool, providing the user image URL, cloth image URL, cloth ID, and cloth description as parameters.

Q: How do I query the status of a try-on task? A: Use the query_tryon_task tool, providing the task ID as a parameter.

Q: What is the tryon_cloth prompt used for? A: The tryon_cloth prompt is used to generate structured prompts for LLMs, guiding them in the try-on process with the necessary user and cloth information.

Q: How do I debug the HeyBeauty MCP Server? A: Use the MCP Inspector by running npm run inspector. This provides a URL to access debugging tools in your browser.

Q: Where can I find the Claude Desktop configuration file? A: On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows: %APPDATA%/Claude/claude_desktop_config.json.

Q: Can I use this server for applications other than Claude Desktop? A: Yes, the HeyBeauty MCP Server can be used with any application that supports the Model Context Protocol (MCP).

Q: What if the path to my heybeauty-mcp changes? A: Make sure to update the ‘args’ path in the configuration file to the proper place. If it is incorrect, the server will not run and you will get an error.