Skip to content

vllm_mlx.mcp.config

MCP configuration loading and validation.

View the complete module source at #L1-L199.

API details

Each callable below includes its exact signature, type annotations, inputs, defaults, return contract, documented exceptions, implementation source, and parsed docstring sections when the source provides them.

vllm_mlx.mcp.config

MCP configuration loading and validation.

vllm_mlx.mcp.config.logger module-attribute 

logger = logging.getLogger(__name__)

vllm_mlx.mcp.config.CONFIG_SEARCH_PATHS module-attribute 

CONFIG_SEARCH_PATHS = ['~/.config/vllm-mlx/mcp.json', '~/.config/vllm-mlx/mcp.yaml']

vllm_mlx.mcp.config.CONFIG_ENV_VAR module-attribute 

CONFIG_ENV_VAR = 'VLLM_MLX_MCP_CONFIG'

vllm_mlx.mcp.config.load_mcp_config 

load_mcp_config(path: Optional[Union[str, Path]] = None) -> MCPConfig

Load MCP configuration from file.

Search order: 1. Explicit path argument 2. VLLM_MLX_MCP_CONFIG environment variable 3. ~/.config/vllm-mlx/mcp.json or mcp.yaml

Parameters:

  • path (Optional[Union[str, Path]], default: None ) –

    Optional explicit path to config file

Returns:

Raises:

  • FileNotFoundError –

    If no config file found

  • ValueError –

    If config is invalid

Source code in vllm_mlx/mcp/config.py 
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
def load_mcp_config(path: Optional[Union[str, Path]] = None) -> MCPConfig:
    """
    Load MCP configuration from file.

    Search order:
    1. Explicit path argument
    2. VLLM_MLX_MCP_CONFIG environment variable
    3. ~/.config/vllm-mlx/mcp.json or mcp.yaml

    Args:
        path: Optional explicit path to config file

    Returns:
        MCPConfig object

    Raises:
        FileNotFoundError: If no config file found
        ValueError: If config is invalid
    """
    config_path = _find_config_file(path)

    if config_path is None:
        logger.info("No MCP config file found, using empty config")
        return MCPConfig()

    logger.info(f"Loading MCP config from: {config_path}")

    # Load file content
    config_path = Path(config_path).expanduser()
    content = config_path.read_text()

    # Parse based on extension
    if config_path.suffix in (".yaml", ".yml"):
        try:
            import yaml

            data = yaml.safe_load(content)
        except ImportError:
            raise ImportError(
                "PyYAML required for .yaml config files: pip install pyyaml"
            )
    else:
        data = json.loads(content)

    return validate_config(data)

vllm_mlx.mcp.config._find_config_file 

_find_config_file(explicit_path: Optional[Union[str, Path]] = None) -> Optional[Path]

Find the config file to use.

Source code in vllm_mlx/mcp/config.py 
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
def _find_config_file(
    explicit_path: Optional[Union[str, Path]] = None,
) -> Optional[Path]:
    """Find the config file to use."""
    # 1. Explicit path
    if explicit_path:
        path = Path(explicit_path).expanduser()
        if path.exists():
            return path
        raise FileNotFoundError(f"MCP config file not found: {explicit_path}")

    # 2. Environment variable
    env_path = os.environ.get(CONFIG_ENV_VAR)
    if env_path:
        path = Path(env_path).expanduser()
        if path.exists():
            return path
        logger.warning(f"MCP config from {CONFIG_ENV_VAR} not found: {env_path}")

    # 3. Search paths
    for search_path in CONFIG_SEARCH_PATHS:
        path = Path(search_path).expanduser()
        if path.exists():
            return path

    return None

vllm_mlx.mcp.config.validate_config 

validate_config(data: Dict[str, Any]) -> MCPConfig

Validate and parse configuration dictionary.

Parameters:

  • data (Dict[str, Any]) –

    Raw configuration dictionary

Returns:

Raises:

  • ValueError –

    If configuration is invalid

Source code in vllm_mlx/mcp/config.py 
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
def validate_config(data: Dict[str, Any]) -> MCPConfig:
    """
    Validate and parse configuration dictionary.

    Args:
        data: Raw configuration dictionary

    Returns:
        Validated MCPConfig object

    Raises:
        ValueError: If configuration is invalid
    """
    if not isinstance(data, dict):
        raise ValueError("MCP config must be a dictionary")

    # Validate servers section
    servers_data = data.get("servers", {})
    if not isinstance(servers_data, dict):
        raise ValueError("'servers' must be a dictionary")

    servers = {}
    for name, server_data in servers_data.items():
        try:
            # Ensure name is set
            if isinstance(server_data, dict):
                server_data = server_data.copy()
                if "skip_security_validation" in server_data:
                    raise ValueError(
                        f"Server '{name}' uses removed field 'skip_security_validation'. "
                        "Use environment variable VLLM_MCP_ALLOW_UNSAFE=1 for explicit local development bypasses."
                    )
                server_data["name"] = name
                servers[name] = MCPServerConfig(**server_data)
            else:
                raise ValueError(f"Server '{name}' config must be a dictionary")
        except TypeError as e:
            raise ValueError(f"Invalid config for server '{name}': {e}")

    # Validate other fields
    max_tool_calls = data.get("max_tool_calls", 10)
    if not isinstance(max_tool_calls, int) or max_tool_calls < 1:
        raise ValueError("'max_tool_calls' must be a positive integer")

    default_timeout = data.get("default_timeout", 30.0)
    if not isinstance(default_timeout, (int, float)) or default_timeout <= 0:
        raise ValueError("'default_timeout' must be a positive number")

    allowed_high_risk_tools = data.get("allowed_high_risk_tools", [])
    if not isinstance(allowed_high_risk_tools, list) or any(
        not isinstance(tool, str) or not tool.strip()
        for tool in allowed_high_risk_tools
    ):
        raise ValueError(
            "'allowed_high_risk_tools' must be a list of non-empty strings"
        )

    return MCPConfig(
        servers=servers,
        max_tool_calls=max_tool_calls,
        default_timeout=default_timeout,
        allowed_high_risk_tools=set(allowed_high_risk_tools),
    )

vllm_mlx.mcp.config.create_example_config 

create_example_config() -> str

Create an example MCP configuration.

Returns:

  • str –

    JSON string with example configuration

Source code in vllm_mlx/mcp/config.py 
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
def create_example_config() -> str:
    """
    Create an example MCP configuration.

    Returns:
        JSON string with example configuration
    """
    example = {
        "servers": {
            "filesystem": {
                "transport": "stdio",
                "command": "npx",
                "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"],
                "enabled": True,
                "timeout": 30,
            },
            "web-search": {
                "transport": "sse",
                "url": "http://localhost:3001/sse",
                "enabled": True,
                "timeout": 60,
            },
            "sqlite": {
                "transport": "stdio",
                "command": "uvx",
                "args": ["mcp-server-sqlite", "--db-path", "data.db"],
                "enabled": True,
            },
        },
        "max_tool_calls": 10,
        "default_timeout": 30.0,
        "allowed_high_risk_tools": [],
    }
    return json.dumps(example, indent=2)

Complete contract reference

Expand any definition for its exact inputs, annotations, defaults, return contract, directly raised exceptions, source-grounded behavior, and immutable line link. This section includes private and nested definitions that ordinary API generators omit.

vllm_mlx.mcp.config.load_mcp_config · function 
vllm_mlx.mcp.config.load_mcp_config(path: Optional[Union[str, Path]] = None) -> MCPConfig

Load MCP configuration from file.

Parameters

Name Type Required Default Description
path Optional[Union[str, Path]] no None Optional explicit path to config file

Returns

  • Type: MCPConfig
  • Direct return expressions: MCPConfig(); validate_config(data)

Exceptions and behavior

Function load_mcp_config calls _find_config_file, logger.info, MCPConfig, Path(config_path).expanduser; can raise ImportError; has 2 explicit return paths. Directly raised exceptions: ImportError.

View source #L26-L70.

vllm_mlx.mcp.config._find_config_file · function 
vllm_mlx.mcp.config._find_config_file(explicit_path: Optional[Union[str, Path]] = None) -> Optional[Path]

Find the config file to use.

Parameters

Name Type Required Default Description
explicit_path Optional[Union[str, Path]] no None Optional positional or keyword input; defaults to None.

Returns

  • Type: Optional[Path]
  • Direct return expressions: path; None

Exceptions and behavior

Function _find_config_file calls Path(explicit_path).expanduser, Path, path.exists, FileNotFoundError; can raise FileNotFoundError; has 2 explicit return paths. Directly raised exceptions: FileNotFoundError.

View source #L73-L98.

vllm_mlx.mcp.config.validate_config · function 
vllm_mlx.mcp.config.validate_config(data: Dict[str, Any]) -> MCPConfig

Validate and parse configuration dictionary.

Parameters

Name Type Required Default Description
data Dict[str, Any] yes none Raw configuration dictionary

Returns

  • Type: MCPConfig
  • Direct return expressions: MCPConfig(servers=servers, max_tool_calls=max_tool_calls, default_timeout=default_timeout, allowed_high_risk_tools=set(…

Exceptions and behavior

Function validate_config calls isinstance, ValueError, data.get, servers_data.items; can raise ValueError; returns MCPConfig(servers=servers, max_tool_calls=max_tool_calls, default_timeout=default_timeout, allowed_high_risk_tools=set(…. Directly raised exceptions: ValueError.

View source #L101-L163.

vllm_mlx.mcp.config.create_example_config · function 
vllm_mlx.mcp.config.create_example_config() -> str

Create an example MCP configuration.

Parameters

This callable has no explicit inputs.

Returns

  • Type: str
  • Direct return expressions: json.dumps(example, indent=2)

Exceptions and behavior

Function create_example_config calls json.dumps; returns json.dumps(example, indent=2). No direct raise statement appears in this definition.

View source #L166-L199.

Complete symbol map

This map also includes private definitions and nested helpers. The signature column exposes every explicit input even when an internal helper has no dedicated parameter prose.

Symbol Kind Signature and inputs What it does Source
load_mcp_config function load_mcp_config(path: Optional[Union[str, Path]] = None) -> MCPConfig Load MCP configuration from file. #L26-L70
_find_config_file function _find_config_file(explicit_path: Optional[Union[str, Path]] = None) -> Optional[Path] Find the config file to use. #L73-L98
validate_config function validate_config(data: Dict[str, Any]) -> MCPConfig Validate and parse configuration dictionary. #L101-L163
create_example_config function create_example_config() -> str Create an example MCP configuration. #L166-L199