"""MCP configuration JSON generation for FastMCP install using Cyclopts.""" import json import sys from pathlib import Path from typing import Annotated import cyclopts import pyperclip from rich import print from fastmcp.utilities.logging import get_logger from .shared import process_common_args logger = get_logger(__name__) def install_mcp_json( file: Path, server_object: str | None, name: str, *, with_editable: Path | None = None, with_packages: list[str] | None = None, env_vars: dict[str, str] | None = None, copy: bool = False, python_version: str | None = None, with_requirements: Path | None = None, project: Path | None = None, ) -> bool: """Generate MCP configuration JSON for manual installation. Args: file: Path to the server file server_object: Optional server object name (for :object suffix) name: Name for the server in MCP config with_editable: Optional directory to install in editable mode with_packages: Optional list of additional packages to install env_vars: Optional dictionary of environment variables copy: If True, copy to clipboard instead of printing to stdout python_version: Optional Python version to use with_requirements: Optional requirements file to install from project: Optional project directory to run within Returns: True if generation was successful, False otherwise """ try: # Build uv run command args = ["run"] # Add Python version if specified if python_version: args.extend(["--python", python_version]) # Add project if specified if project: args.extend(["--project", str(project)]) # Collect all packages in a set to deduplicate packages = {"fastmcp"} if with_packages: packages.update(pkg for pkg in with_packages if pkg) # Add all packages with --with for pkg in sorted(packages): args.extend(["--with", pkg]) if with_editable: args.extend(["--with-editable", str(with_editable)]) if with_requirements: args.extend(["--with-requirements", str(with_requirements)]) # Build server spec from parsed components if server_object: server_spec = f"{file.resolve()}:{server_object}" else: server_spec = str(file.resolve()) # Add fastmcp run command args.extend(["fastmcp", "run", server_spec]) # Build MCP server configuration server_config = { "command": "uv", "args": args, } # Add environment variables if provided if env_vars: server_config["env"] = env_vars # Wrap with server name as root key config = {name: server_config} # Convert to JSON json_output = json.dumps(config, indent=2) # Handle output if copy: pyperclip.copy(json_output) print(f"[green]MCP configuration for '{name}' copied to clipboard[/green]") else: # Print to stdout (for piping) print(json_output) return True except Exception as e: print(f"[red]Failed to generate MCP configuration: {e}[/red]") return False async def mcp_json_command( server_spec: str, *, server_name: Annotated[ str | None, cyclopts.Parameter( name=["--name", "-n"], help="Custom name for the server in MCP config", ), ] = None, with_editable: Annotated[ Path | None, cyclopts.Parameter( name=["--with-editable", "-e"], help="Directory with pyproject.toml to install in editable mode", ), ] = None, with_packages: Annotated[ list[str], cyclopts.Parameter( "--with", help="Additional packages to install", negative=False, ), ] = [], env_vars: Annotated[ list[str], cyclopts.Parameter( "--env", help="Environment variables in KEY=VALUE format", negative=False, ), ] = [], env_file: Annotated[ Path | None, cyclopts.Parameter( "--env-file", help="Load environment variables from .env file", ), ] = None, copy: Annotated[ bool, cyclopts.Parameter( "--copy", help="Copy configuration to clipboard instead of printing to stdout", negative=False, ), ] = False, python: Annotated[ str | None, cyclopts.Parameter( "--python", help="Python version to use (e.g., 3.10, 3.11)", ), ] = None, with_requirements: Annotated[ Path | None, cyclopts.Parameter( "--with-requirements", help="Requirements file to install dependencies from", ), ] = None, project: Annotated[ Path | None, cyclopts.Parameter( "--project", help="Run the command within the given project directory", ), ] = None, ) -> None: """Generate MCP configuration JSON for manual installation. Args: server_spec: Python file to install, optionally with :object suffix """ file, server_object, name, packages, env_dict = await process_common_args( server_spec, server_name, with_packages, env_vars, env_file ) success = install_mcp_json( file=file, server_object=server_object, name=name, with_editable=with_editable, with_packages=packages, env_vars=env_dict, copy=copy, python_version=python, with_requirements=with_requirements, project=project, ) if not success: sys.exit(1)