pyproject.toml

[project]
name = "mcp-foxxy-bridge"
description = "A MCP Forward Proxy Bridge designed to be a one-to-many bridge allowing you to use a single MCP server to communicate with many MCP servers transparently."
authors = [{ name = "Billy Bryant", email = "billy@billyjbryant.com" }]
license = { file = "LICENSE" }
readme = "README.md"
classifiers = [
    "Development Status :: 4 - Beta",
    "Environment :: Console",
    "Intended Audience :: Developers",
    "Intended Audience :: Information Technology",
    "Intended Audience :: System Administrators",
    "License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)",
    "Operating System :: MacOS",
    "Operating System :: POSIX :: Linux",
    "Operating System :: Unix",
    "Programming Language :: Python",
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3 :: Only",
    "Programming Language :: Python :: 3.11",
    "Programming Language :: Python :: 3.12",
    "Programming Language :: Python :: 3.13",
    "Topic :: Software Development :: Libraries :: Python Modules",
    "Topic :: Utilities",
    "Typing :: Typed",
]
dynamic = ["version"]
requires-python = ">=3.11"
dependencies = [
    "mcp>=1.8.0,<2.0.0",
    "uvicorn>=0.34.0",
    "jsonschema>=4.0.0",
    "watchdog>=3.0.0",
    "rich>=13.0.0",
    "aiohttp>=3.12.15",
    "events>=0.5",
    "cryptography>=3.4.8",
    "keyring>=23.0.0",
    "httpx[http2]>=0.28.0",
    "psutil>=5.9.0",
    "pyyaml>=6.0.0",
    "click>=8.1.0",
    "rich-click>=1.7.0",
]

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

[project.urls]
Homepage = "https://github.com/billyjbryant/mcp-foxxy-bridge"
Source = "https://github.com/billyjbryant/mcp-foxxy-bridge"
Documentation = "https://github.com/billyjbryant/mcp-foxxy-bridge"
Changelog = "https://github.com/billyjbryant/mcp-foxxy-bridge/releases"

[project.scripts]
foxxy-bridge = "mcp_foxxy_bridge.cli.main:cli"
mcp-foxxy-bridge = "mcp_foxxy_bridge.cli.main:cli"

[tool.hatch.build.targets.wheel]
packages = ["src/mcp_foxxy_bridge"]

[tool.hatch.version]
path = "VERSION"
pattern = "(?P<version>\\d+\\.\\d+\\.\\d+.*)"

[tool.uv]
dev-dependencies = [
    "pytest>=8.3.3",
    "pytest-asyncio>=0.25.0",
    "coverage>=7.6.0",
    "mypy>=1.0.0",
    "hatch>=1.12.0",
    "ruff>=0.12.5",
    "pre-commit>=3.5.0",
]

[tool.coverage.run]
branch = true

[tool.coverage.report]
skip_covered = true
show_missing = true
precision = 2
exclude_lines = [
    'pragma: no cover',
    'raise NotImplementedError',
    'if TYPE_CHECKING:',
    'if typing.TYPE_CHECKING:',
    '@overload',
    '@typing.overload',
    '\(Protocol\):$',
    'typing.assert_never',
    '$\s*assert_never\(',
    'if __name__ == .__main__.:',
]

[tool.mypy]
allow_redefinition = false
disallow_untyped_defs = true
follow_imports = "normal"
follow_untyped_imports = true
no_implicit_optional = true
show_error_code_links = true
show_error_codes = true
strict = true
warn_redundant_casts = true
warn_return_any = true
warn_unreachable = true
warn_unused_configs = true
warn_unused_ignores = true

# Exclude virtual environment and other non-source files
exclude = [
    "use/",
    ".venv/",
    "venv/",
    "env/",
    ".mypy_cache/",
    "__pycache__/",
]

[tool.ruff.lint]
select = ["ALL"]
ignore = [
    "EM101",  # Exception must not use a string literal, assign to variable first
    "TRY003", # Avoid specifying long messages outside the exception class
    "ERA001", # Found commented-out code
    "COM812", # Trailing comma missing (conflicts with formatter)
    "TD002",  # Missing author in TODO (false positives with our format)
    "TD003",  # Missing issue link for TODO (false positives with our format)
    "FIX002", # Line contains TODO (expected in development)
    "C901",   # Function is too complex (complex functions - future refactor)
    "PLR0912", # Too many branches (complex validation - future refactor)
    "PLR0915", # Too many statements (complex functions - future refactor)

    # Style preferences - reasonable to ignore for this codebase
    "G004",   # F-strings in logging (more readable than % formatting)
    "FBT001", # Boolean positional arguments (common in config APIs)
    "FBT002", # Boolean default arguments (common in config APIs)
    "PLR2004", # Magic value comparisons (obvious values like 20, 100)
    "PLR0913", # Too many arguments (sometimes necessary for APIs)
    "ANN401", # Any type annotation (sometimes necessary)
    "ANN003", # Missing type annotation for **kwargs
    "D107",   # Missing docstring in __init__ (often obvious)
    "ARG001", # Unused function argument (often required by interfaces)
    "PLW0603", # Global statement (sometimes necessary)
    "TRY401", # Verbose log message (exception details useful in logs)
    "BLE001", # Blind except - using proper graceful degradation pattern
    "TRY300", # Consider moving statement to else block (often makes code less readable)
    "TRY301", # Abstract raise to inner function (often makes code less readable)
    "SIM102", # Use single if statement (sometimes nested is clearer)
    "EM102",  # Exception must not use f-string (f-strings are fine for exceptions)
    "ASYNC109", # Async function with timeout parameter (legitimate pattern)
    "ANN003", # Missing type annotation for **kwargs (sometimes necessary)
    "B023",   # Function definition does not bind loop variable (complex closure patterns)
    "PLR0911", # Too many return statements (complex OAuth/API handlers need many returns)
]

[tool.ruff.lint.per-file-ignores]
"tests/*" = [
    "S101",    # Use of assert detected (allowed in tests)
    "INP001",  # File is part of an implicit namespace package
    "D102",    # Missing docstring in public method (not required in tests)
    "D103",    # Missing docstring in public function (not required in tests)
    "ANN001",  # Missing type annotation for function argument
    "ANN201",  # Missing return type annotation for public function
    "ANN202",  # Missing return type annotation for private function
    "ANN003",  # Missing type annotation for **kwargs
    "PTH123",  # Use of open() instead of Path.open() (acceptable in tests)
    "RUF015",  # Prefer next(iter()) over single element slice (acceptable in tests)
    "F841",    # Local variable assigned but never used (test setup variables)
    "PLC0415", # Import should be at top-level (acceptable in tests)
    "PLR0913", # Too many arguments (common in test fixtures)
    "S106",    # Possible hardcoded password (test data)
    "S105",    # Possible hardcoded password (test data)
    "SIM117",  # Use single with statement (nested context managers are fine in tests)
    "PLR2004", # Magic value used in comparison (test values can be literals)
    "S108",    # Probable insecure usage of temp file/directory (acceptable in tests)
    "ARG001",  # Unused function argument (fixtures often unused)
    "FBT001",  # Boolean positional argument (common in test assertions)
    "FBT002",  # Boolean default argument (common in test fixtures)
    "FBT003",  # Boolean positional value in function call (test data/mocking)
    "SLF001",  # Private member accessed (testing internal methods)
    "S110",    # try-except-pass (acceptable in tests for error tolerance)
    "SIM105",  # Use contextlib.suppress (sometimes clearer to use try-except in tests)
]
"src/mcp_foxxy_bridge/cli/*" = [
    "S324",    # MD5 hash is acceptable for non-security purposes (daemon naming)
    "S603",    # Subprocess execution is expected in daemon manager
    "S110",    # Exception suppression is acceptable for daemon cleanup
    "ASYNC220", # Async subprocess restrictions are relaxed for CLI tools
    "ASYNC221", # Async subprocess restrictions are relaxed for CLI tools
    "SIM105",  # Contextlib.suppress preference is relaxed for CLI tools
    "DTZ005",  # Timezone awareness is less critical for CLI daemon timestamps
]
"src/mcp_foxxy_bridge/utils/bridge_config.py" = [
    "PLC0415", # Import should be at the top-level (intentional to avoid circular imports)
]
"src/mcp_foxxy_bridge/cli/commands/oauth.py" = [
    "PLC0415", # Import should be at the top-level (intentional to avoid circular imports)
]
"src/mcp_foxxy_bridge/cli/commands/server.py" = [
    "PLC0415", # Import should be at the top-level (intentional to avoid circular imports)
]
"src/mcp_foxxy_bridge/cli/commands/tool.py" = [
    "PLC0415", # Import should be at the top-level (intentional to avoid circular imports)
]

[tool.ruff.lint.pydocstyle]
convention = "google"

[tool.ruff]
line-length = 120

[tool.pytest.ini_options]
pythonpath = "src"
addopts = ["--import-mode=importlib"]
asyncio_mode = "auto"
asyncio_default_fixture_loop_scope = "function"