Package com.tnsai.mcp.registry

Class CamelMcpHubClient

java.lang.Object

com.tnsai.mcp.registry.CamelMcpHubClient

All Implemented Interfaces:

McpRegistrySource

public class CamelMcpHubClient
extends Object
implements McpRegistrySource

Registry client for the Camel MCP Hub at mcp.camel-ai.org.

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

Constructor Summary

Constructors

Constructor	Description
CamelMcpHubClient()	Creates a CamelMcpHubClient with default HTTP client.
CamelMcpHubClient(HttpClient httpClient)	Creates a CamelMcpHubClient 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

CamelMcpHubClient

public CamelMcpHubClient()

Creates a CamelMcpHubClient with default HTTP client.

CamelMcpHubClient

public CamelMcpHubClient(HttpClient httpClient)

Creates a CamelMcpHubClient 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