yera.tools.mcp.catalogue
Rebuildable SQLite catalogue for discovered MCP tools.
Symbols
MCPServerRecord
Metadata retained for one imported MCP server.
Fields
Methods
MCPServerRecord.__init__
__init__(
name: str,
url: str,
) → NoneMCPToolRecord
Metadata retained for one tool discovered from an MCP server.
Fields
Methods
MCPToolRecord.from_discovered_tool
from_discovered_tool(
server_name: str,
tool: Tool,
) → SelfBuild a catalogue record from MCP discovery metadata.
Parameters
Yera's configured name for the supplying server.
Tool definition returned by the MCP server.
Returns
A serializable catalogue record retaining the discovered metadata.
MCPToolRecord.__init__
__init__(
server_name: str,
name: str,
input_schema: dict[str, object],
title: str | None = None,
description: str | None = None,
output_schema: dict[str, object] | None = None,
annotations: dict[str, object] | None = None,
icons: tuple[dict[str, object], ...] = (),
execution: dict[str, object] | None = None,
meta: dict[str, object] | None = None,
) → NoneSQLiteMCPCatalogue
Cache discovered MCP metadata in a persistent, rebuildable database.
Methods
SQLiteMCPCatalogue.__init__
__init__(
path: Path | None = None,
) → NoneConfigure a persistent, rebuildable MCP catalogue.
Parameters
SQLite database path, or None to use Yera's standard
mcp.db location.
SQLiteMCPCatalogue.__enter__
__enter__() → SQLiteMCPCatalogueOpen the catalogue, rebuilding unsupported schemas.
Returns
This catalogue with an initialised database connection.
SQLiteMCPCatalogue.__exit__
__exit__(
exc_type: type[BaseException] | None,
exc_value: BaseException | None,
traceback: TracebackType | None,
) → NoneClose the catalogue connection.
Parameters
Type of an exception leaving the context, or None.
Exception leaving the context, or None.
Traceback for the exception, or None.
SQLiteMCPCatalogue.replace_server
replace_server(
server: MCPServerRecord,
tools: list[MCPToolRecord],
) → NoneAtomically replace one server and all its discovered tools.
The transaction is rolled back if persistence fails.
Parameters
Server metadata to create or replace.
Complete discovered tool set for the server.
Raises
If the catalogue is not open.
If a tool belongs to a different server.
SQLiteMCPCatalogue.remove_server
remove_server(
server_name: str,
) → NoneAtomically remove one server and all its discovered tools.
The transaction is rolled back if persistence fails.
Parameters
Configured name of the server to remove.
Raises
If the catalogue is not open.
SQLiteMCPCatalogue.server
server(
server_name: str,
) → MCPServerRecord | NoneReturn one configured catalogue server.
Parameters
Name of the server to retrieve.
Returns
The server record, or None when it is absent.
Raises
If the catalogue is not open.
SQLiteMCPCatalogue.tools_for_server
tools_for_server(
server_name: str,
) → list[MCPToolRecord]Return one server's imported tools ordered by tool name.
Parameters
Configured name of the server whose tools should be returned.
Returns
Imported tool records ordered by tool name, or an empty list when the server has no imported tools.
Raises
If the catalogue is not open.