Frequently Asked Questions (FAQ) about UBOS Asset Marketplace MCP Server

Q: What is an MCP Server? A: MCP (Model Context Protocol) Server is a server that standardizes how applications provide context to LLMs, allowing AI models to access and interact with external data sources and tools. In the context of UBOS Asset Marketplace, the MCP server provides access to Swagger/OpenAPI documentation and allows making API requests based on the specification.

Q: What are the key features of the UBOS Asset Marketplace MCP Server? A: The key features include loading Swagger documentation from a URL, making API requests based on the Swagger spec, supporting authentication via API key, caching Swagger spec for better performance, and validating requests against the Swagger spec.

Q: How do I set up the UBOS Asset Marketplace MCP Server locally? A: To set up the server locally, follow these steps: 1. Install dependencies using npm install. 2. Build the TypeScript code using npm run build. 3. Configure the necessary environment variables (SWAGGER_URL, AUTH_KEY). 4. Run the server in development mode using npm run dev or in production mode using npm start.

Q: What environment variables are required to run the server? A: The server requires the SWAGGER_URL environment variable, which specifies the URL to the Swagger specification. The AUTH_KEY environment variable is optional and is used for API request authentication.

Q: How can I access the Swagger documentation using the MCP server? A: You can access the full Swagger documentation through the swagger-doc resource, which has the URI swagger://documentation.

Q: How do I make API requests using the MCP server? A: You can use the makeRequest tool, providing the API endpoint path, HTTP method, optional path/query parameters, and an optional request body.

Q: Can I deploy the MCP server on Smithery.ai? A: Yes, the server is configured for deployment on Smithery.ai. You need a Dockerfile to build and run the server and a smithery.yaml configuration file.

Q: What is UBOS, and how does the MCP Server fit into the UBOS ecosystem? A: UBOS is a full-stack AI Agent Development Platform focused on bringing AI Agents to every business department. The MCP Server in the UBOS Asset Marketplace serves as a component that allows AI Agents to seamlessly interact with external APIs, enhancing their capabilities within the UBOS platform.