Skip to main content

​
fastmcp.cli.discovery

Discover MCP servers configured in editor config files. Scans filesystem-readable config files from editors like Claude Desktop, Claude Code, Cursor, Gemini CLI, and Goose, as well as project-level mcp.json files. Each discovered server can be resolved by name (or source:name) so the CLI can connect without requiring a URL or file path.

​
Functions

​
discover_servers 

discover_servers(start_dir: Path | None = None) -> list[DiscoveredServer]
Run all scanners and return the combined results. Duplicate names across sources are preserved — callers can use :pyattr:DiscoveredServer.qualified_name to disambiguate.

​
resolve_name 

resolve_name(name: str, start_dir: Path | None = None) -> ClientTransport
Resolve a server name (or source:name) to a transport. Raises :class:ValueError when the name is not found or is ambiguous.

​
Classes

​
DiscoveredServer

A single MCP server found in an editor or project config. Methods:

​
qualified_name 

qualified_name(self) -> str
Fully qualified source:name identifier.

​
transport_summary 

transport_summary(self) -> str
Human-readable one-liner describing the transport.