aiida_mcp.plugins package

Plugin tools discovered via the aiida_mcp.plugins entry point group.

Any installed package can expose calcjob-specific MCP tools by declaring, in its own pyproject.toml, an entry point in the aiida_mcp.plugins group that points at a module providing is_available() -> bool and register(mcp) -> None, e.g.:

[project.entry-points."aiida_mcp.plugins"]
dlpoly = "aiida_dlpoly.mcp"

That example is real: DL_POLY’s tools live in aiida_dlpoly.mcp, in the aiida-dlpoly package itself, not here — ChemShell’s tools likewise live in aiida_chemshell.mcp, in the aiida-chemshell package. aiida-mcp still bundles a plugin module for mlip (see aiida_mcp/plugins/mlip.py), registered through this same mechanism via the entry point declared in this project’s own pyproject.toml.

aiida_mcp.plugins.clear_entry_point_cache() → None

Clear cached entry point lookups so newly installed plugins can be found.

AiiDA caches entry point lookups (aiida.plugins.entry_point.eps/eps_select) for the lifetime of the process, and Python’s import system caches which directories/distributions exist on sys.path. A plugin package installed after the server started would otherwise never be detected as available. Call this before register_all to pick up newly installed plugins.

aiida_mcp.plugins.register_all(mcp: MCPServer) → list[str]

Register the tools of every installed plugin and return the ones registered.

Parameters:

mcp (MCPServer) – The server to register plugin tools on.

Returns:

Names of the aiida_mcp.plugins entry points that were registered.

Return type:

list[str]

Submodules