b25056fadd
This PR adds support for running multiple MCP (STDIO) servers and serving them up via a single mcp-proxy instance, each with a named path in the URL. Example usage: ``` mcp-proxy --port 8080 --named-server fetch 'uvx mcp-server-fetch' --named-server github 'npx -y @modelcontextprotocol/server-github' ``` Would serve: - `http://localhost:8080/servers/fetch` - `http://localhost:8080/servers/github` I've also added the ability to provide a standard mcp client config file with accompanying tests. Please feel free to make any changes as you see fit, or reject the PR if it does not align with your goals. Thank you, --------- Co-authored-by: Magnus Tidemann <magnustidemann@gmail.com> Co-authored-by: Sergey Parfenyuk <sergey.parfenyuk@gmail.com>
100 lines
3.3 KiB
Python
100 lines
3.3 KiB
Python
"""Configuration loader for MCP proxy.
|
|
|
|
This module provides functionality to load named server configurations from JSON files.
|
|
"""
|
|
|
|
import json
|
|
import logging
|
|
from pathlib import Path
|
|
|
|
from mcp.client.stdio import StdioServerParameters
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
|
|
def load_named_server_configs_from_file(
|
|
config_file_path: str,
|
|
base_env: dict[str, str],
|
|
) -> dict[str, StdioServerParameters]:
|
|
"""Loads named server configurations from a JSON file.
|
|
|
|
Args:
|
|
config_file_path: Path to the JSON configuration file.
|
|
base_env: The base environment dictionary to be inherited by servers.
|
|
|
|
Returns:
|
|
A dictionary of named server parameters.
|
|
|
|
Raises:
|
|
FileNotFoundError: If the config file is not found.
|
|
json.JSONDecodeError: If the config file contains invalid JSON.
|
|
ValueError: If the config file format is invalid.
|
|
"""
|
|
named_stdio_params: dict[str, StdioServerParameters] = {}
|
|
logger.info("Loading named server configurations from: %s", config_file_path)
|
|
|
|
try:
|
|
with Path(config_file_path).open() as f:
|
|
config_data = json.load(f)
|
|
except FileNotFoundError:
|
|
logger.exception("Configuration file not found: %s", config_file_path)
|
|
raise
|
|
except json.JSONDecodeError:
|
|
logger.exception("Error decoding JSON from configuration file: %s", config_file_path)
|
|
raise
|
|
except Exception as e:
|
|
logger.exception(
|
|
"Unexpected error opening or reading configuration file %s",
|
|
config_file_path,
|
|
)
|
|
error_message = f"Could not read configuration file: {e}"
|
|
raise ValueError(error_message) from e
|
|
|
|
if not isinstance(config_data, dict) or "mcpServers" not in config_data:
|
|
msg = f"Invalid config file format in {config_file_path}. Missing 'mcpServers' key."
|
|
logger.error(msg)
|
|
raise ValueError(msg)
|
|
|
|
for name, server_config in config_data.get("mcpServers", {}).items():
|
|
if not isinstance(server_config, dict):
|
|
logger.warning(
|
|
"Skipping invalid server config for '%s' in %s. Entry is not a dictionary.",
|
|
name,
|
|
config_file_path,
|
|
)
|
|
continue
|
|
if not server_config.get("enabled", True): # Default to True if 'enabled' is not present
|
|
logger.info("Named server '%s' from config is not enabled. Skipping.", name)
|
|
continue
|
|
|
|
command = server_config.get("command")
|
|
command_args = server_config.get("args", [])
|
|
|
|
if not command:
|
|
logger.warning(
|
|
"Named server '%s' from config is missing 'command'. Skipping.",
|
|
name,
|
|
)
|
|
continue
|
|
if not isinstance(command_args, list):
|
|
logger.warning(
|
|
"Named server '%s' from config has invalid 'args' (must be a list). Skipping.",
|
|
name,
|
|
)
|
|
continue
|
|
|
|
named_stdio_params[name] = StdioServerParameters(
|
|
command=command,
|
|
args=command_args,
|
|
env=base_env.copy(),
|
|
cwd=None,
|
|
)
|
|
logger.info(
|
|
"Configured named server '%s' from config: %s %s",
|
|
name,
|
|
command,
|
|
" ".join(command_args),
|
|
)
|
|
|
|
return named_stdio_params
|