Package com.tnsai.mcp.registry

Class SmitheryClient

java.lang.Object

com.tnsai.mcp.registry.SmitheryClient

All Implemented Interfaces:

McpRegistrySource

public class SmitheryClient
extends Object
implements McpRegistrySource

Registry client for Smithery at smithery.ai.

Fetches MCP server metadata from the Smithery registry. The HTTP fetch is performed via a protected method that can be overridden in tests.

Constructor Summary

Constructors

Constructor	Description
SmitheryClient()	Creates a SmitheryClient with default HTTP client.
SmitheryClient(HttpClient httpClient)	Creates a SmitheryClient with a custom HTTP client.

Method Summary

Modifier and Type	Method	Description
Optional<McpServerEntry>	getServer(String name)	Looks up a specific server by name.
String	getSourceName()	Returns the name of this registry source.
List<McpServerEntry>	listAll()	Lists all available servers from this registry.
List<McpServerEntry>	search(String query)	Searches the registry for servers matching the given query.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

SmitheryClient

public SmitheryClient()

Creates a SmitheryClient with default HTTP client.

SmitheryClient

public SmitheryClient(HttpClient httpClient)

Creates a SmitheryClient with a custom HTTP client.

Parameters:

httpClient - the HTTP client to use

Method Details

getSourceName

public String getSourceName()

Description copied from interface: McpRegistrySource

Returns the name of this registry source.

Specified by:

getSourceName in interface McpRegistrySource

Returns:

source name (e.g. "official", "smithery", "mcpservers.org", "camel")

search

public List<McpServerEntry> search(String query)
                            throws IOException

Description copied from interface: McpRegistrySource

Searches the registry for servers matching the given query.

Specified by:

search in interface McpRegistrySource

Parameters:

query - search query string

Returns:

list of matching server entries

Throws:

IOException - if the registry cannot be reached

getServer

public Optional<McpServerEntry> getServer(String name)
                                   throws IOException

Description copied from interface: McpRegistrySource

Looks up a specific server by name.

Specified by:

getServer in interface McpRegistrySource

Parameters:

name - the server name

Returns:

the server entry if found

Throws:

IOException - if the registry cannot be reached

listAll

public List<McpServerEntry> listAll()
                             throws IOException

Description copied from interface: McpRegistrySource

Lists all available servers from this registry.

Specified by:

listAll in interface McpRegistrySource

Returns:

list of all server entries

Throws:

IOException - if the registry cannot be reached