Package com.tnsai.mcp.registry

Class OfficialRegistryClient

java.lang.Object

com.tnsai.mcp.registry.OfficialRegistryClient

All Implemented Interfaces:

McpRegistrySource

public class OfficialRegistryClient
extends Object
implements McpRegistrySource

Registry client for the official MCP registry at registry.modelcontextprotocol.io.

Fetches MCP server metadata from the official Model Context Protocol registry using its HTTP API. Responses are parsed from JSON into McpServerEntry records.

The HTTP fetch is performed via a protected method (fetchJson(String)) that can be overridden in tests to return canned responses.

Constructor Summary

Constructors

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

OfficialRegistryClient

public OfficialRegistryClient()

Creates an OfficialRegistryClient with default HTTP client.

OfficialRegistryClient

public OfficialRegistryClient(HttpClient httpClient)

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