Package com.tnsai.mcp.registry

Class McpServersOrgClient

java.lang.Object

com.tnsai.mcp.registry.McpServersOrgClient

All Implemented Interfaces:

McpRegistrySource

public class McpServersOrgClient
extends Object
implements McpRegistrySource

Registry client for mcpservers.org directory.

Fetches MCP server metadata from the mcpservers.org community directory. The HTTP fetch is performed via a protected method that can be overridden in tests.

Constructor Summary

Constructors

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

McpServersOrgClient

public McpServersOrgClient()

Creates an McpServersOrgClient with default HTTP client.

McpServersOrgClient

public McpServersOrgClient(HttpClient httpClient)

Creates an McpServersOrgClient 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