π The fast, Pythonic way to build MCP servers and clients.
feat: add `--config-path` flag to claude-desktop install command (#3380)
Sumanshu Nankana34d848b16a6e
diff --git a/docs/cli/install-mcp.mdx b/docs/cli/install-mcp.mdxindex bf1b60b36..0171b7854 100644--- a/docs/cli/install-mcp.mdx+++ b/docs/cli/install-mcp.mdx@@ -65,6 +65,7 @@ See [Server Configuration](/deployment/server-configuration) for the full config| Python | `--python` | Python version (e.g., `3.11`) || Project | `--project` | Run within a uv project directory || Requirements | `--with-requirements` | Install from a requirements file |+| Config Path | `--config-path` | Custom path to Claude Desktop config directory (`claude-desktop` only) |## Examples@@ -92,6 +93,10 @@ fastmcp install cursor server.py --env-file .envfastmcp install claude-desktop server.py \--python 3.11 \--with-requirements requirements.txt++# With custom config path (claude-desktop only)+fastmcp install claude-desktop server.py \+ --config-path "C:\Users\username\AppData\Local\Packages\Claude_xyz\LocalCache\Roaming\Claude"```## Generating MCP JSONdiff --git a/src/fastmcp/cli/install/claude_desktop.py b/src/fastmcp/cli/install/claude_desktop.pyindex 83755c162..780b97c36 100644--- a/src/fastmcp/cli/install/claude_desktop.py+++ b/src/fastmcp/cli/install/claude_desktop.py@@ -17,8 +17,19 @@ from .shared import process_common_argslogger = get_logger(__name__)-def get_claude_config_path() -> Path | None:- """Get the Claude config directory based on platform."""+def get_claude_config_path(config_path: Path | None = None) -> Path | None:+ """Get the Claude config directory based on platform.++ Args:+ config_path: Optional custom path to the Claude Desktop config directory+ """++ if config_path:+ if not config_path.exists():+ print(f"[red]The specified config path does not exist: {config_path}[/red]")+ return None+ return config_path+if sys.platform == "win32":path = Path(Path.home(), "AppData", "Roaming", "Claude")elif sys.platform == "darwin":@@ -46,6 +57,7 @@ def install_claude_desktop(python_version: str | None = None,with_requirements: Path | None = None,project: Path | None = None,+ config_path: Path | None = None,) -> bool:"""Install FastMCP server in Claude Desktop.@@ -59,16 +71,18 @@ def install_claude_desktop(python_version: Optional Python version to usewith_requirements: Optional requirements file to install fromproject: Optional project directory to run within+ config_path: Optional custom path to Claude Desktop config directoryReturns:True if installation was successful, False otherwise"""- config_dir = get_claude_config_path()+ config_dir = get_claude_config_path(config_path=config_path)if not config_dir:- print(- "[red]Claude Desktop config directory not found.[/red]\n"- "[blue]Please ensure Claude Desktop is installed and has been run at least once to initialize its config.[/blue]"- )+ if not config_path:+ print(+ "[red]Claude Desktop config directory not found.[/red]\n"+ "[blue]Please ensure Claude Desktop is installed and has been run at least once to initialize its config.[/blue]"+ )return Falseconfig_file = config_dir / "claude_desktop_config.json"@@ -180,6 +194,13 @@ async def claude_desktop_command(help="Run the command within the given project directory",),] = None,+ config_path: Annotated[+ Path | None,+ cyclopts.Parameter(+ "--config-path",+ help="Custom path to Claude Desktop config directory",+ ),+ ] = None,) -> None:"""Install an MCP server in Claude Desktop.@@ -204,6 +225,7 @@ async def claude_desktop_command(python_version=python,with_requirements=with_requirements,project=project,+ config_path=config_path,)if not success:diff --git a/tests/cli/test_install.py b/tests/cli/test_install.pyindex 81fde3c1c..6b354c9b7 100644--- a/tests/cli/test_install.py+++ b/tests/cli/test_install.py@@ -142,6 +142,20 @@ class TestClaudeDesktopInstall:assert bound.arguments["project"] == Path("/my/project")assert bound.arguments["with_requirements"] == Path("reqs.txt")+ def test_claude_desktop_with_config_path(self):+ """Test claude-desktop install with custom config path."""+ command, bound, _ = install_app.parse_args(+ ["claude-desktop", "server.py", "--config-path", "/custom/path/Claude"]+ )++ assert bound.arguments["config_path"] == Path("/custom/path/Claude")++ def test_claude_desktop_without_config_path(self):+ """Test claude-desktop install without config path defaults to None."""+ command, bound, _ = install_app.parse_args(["claude-desktop", "server.py"])++ assert bound.arguments.get("config_path") is None+class TestCursorInstall:"""Test cursor install command."""