MCP Workspace Server

"""Command-line interface for the MCP Filesystem Server.""" import os import sys from typing import List, Optional import typer from typing_extensions import Annotated from .server import mcp app = typer.Typer( name="mcp-filesystem", help="MCP Filesystem Server", add_completion=False, ) @app.callback(invoke_without_command=True) def main( directories: Annotated[ Optional[List[str]], typer.Argument( help="Allowed directories (defaults to current directory if none provided)", show_default=False, ), ] = None, transport: Annotated[ Optional[str], typer.Option( "--transport", "-t", help="Transport protocol to use", ), ] = None, host: Annotated[ Optional[str], typer.Option( "--host", help="Host for SSE transport", ), ] = None, port: Annotated[ Optional[int], typer.Option( "--port", "-p", help="Port for SSE transport", ), ] = None, debug: Annotated[ bool, typer.Option( "--debug", "-d", help="Enable debug logging", ), ] = False, version: Annotated[ bool, typer.Option( "--version", "-v", help="Show version information", ), ] = False, ) -> None: """Run the MCP Filesystem Server. By default, the server will only allow access to the current directory. You can specify one or more allowed directories as arguments. """ if version: show_version() return # Load defaults from config from .server import load_config config = load_config() mcp_cfg = config.get("mcp", {}) transport = (transport or mcp_cfg.get("transport") or "sse").lower() host = host or mcp_cfg.get("host") or "0.0.0.0" port = port if port is not None else int(mcp_cfg.get("port") or 18089) # Set allowed directories in environment for the server to pick up if directories: os.environ["MCP_ALLOWED_DIRS"] = os.pathsep.join(directories) # Set debug mode if requested if debug: os.environ["FASTMCP_LOG_LEVEL"] = "DEBUG" try: if transport == "sse": os.environ["FASTMCP_PORT"] = str(port) os.environ["FASTMCP_HOST"] = host mcp.run(transport="sse") else: mcp.run(transport="stdio") except KeyboardInterrupt: print("\nShutting down...", file=sys.stderr) sys.exit(0) except Exception as e: print(f"Error: {e}", file=sys.stderr) sys.exit(1) def show_version() -> None: """Show version information.""" try: from importlib.metadata import version as get_version version = get_version("mcp-filesystem") except ImportError: version = "unknown" print(f"MCP Filesystem Server v{version}") print("A Model Context Protocol server for filesystem operations") if __name__ == "__main__": app()