Smithery Registry OpenAPI Server
by chinpeerapat
This server provides an OpenAPI interface to the Smithery Registry API, allowing you to search and obtain launch configurations for Model Context Protocol (MCP) servers. It enables easy integration with OpenAPI tools and clients.
Last updated: N/A
What is Smithery Registry OpenAPI Server?
The Smithery Registry OpenAPI Server is an API server that provides an OpenAPI interface to the Smithery Registry API. It allows users to search for and retrieve launch configurations for Model Context Protocol (MCP) servers.
How to use Smithery Registry OpenAPI Server?
To use the server, first install the dependencies using pip install -r requirements.txt. Then, run the server using uvicorn main:app --host 0.0.0.0 --port 8000 --reload. Authenticate requests with a bearer token in the Authorization header. Use the provided API endpoints to list servers, get server details, and create WebSocket URLs.
Key features of Smithery Registry OpenAPI Server
List available MCP servers with advanced filtering
Get detailed server information including connection configurations
Generate WebSocket URLs with base64-encoded configurations
Authentication via bearer token
Compatible with OpenAPI tools and clients
Use cases of Smithery Registry OpenAPI Server
Automated deployment of MCP servers
Integration with existing OpenAPI workflows
Programmatic access to server configurations
Building custom UIs for managing MCP servers
FAQ from Smithery Registry OpenAPI Server
How do I authenticate with the API?
How do I authenticate with the API?
You need to provide a bearer token in the Authorization header. Obtain a token from your Smithery user profile under API keys.
How do I search for servers?
How do I search for servers?
Use the GET /servers endpoint with the q query parameter for semantic search. Advanced filtering syntax is supported, such as owner:username or repo:repository-name.
How do I create a WebSocket URL?
How do I create a WebSocket URL?
Use the POST /create-websocket-url endpoint with the qualifiedName and config in the request body. The config object must match the server's schema and will be base64-encoded in the URL.
What is the format of the WebSocket URL?
What is the format of the WebSocket URL?
The URL format is https://server.smithery.ai/${qualifiedName}/ws?config=${base64encode(config)}. The config must comply with the server's configSchema and be base64-encoded JSON.
Is this server compatible with OpenAPI tools?
Is this server compatible with OpenAPI tools?
Yes, this server is designed to be compatible with any OpenAPI-compliant tools and frameworks. The API follows RESTful conventions and provides detailed OpenAPI documentation at the /docs endpoint when running.