pyproject.toml

[build-system]
requires = ["hatchling", "hatch-vcs"]
build-backend = "hatchling.build"

[project]
name = "linux-mcp-server"
description = "MCP server for read-only Linux system administration, diagnostics, and troubleshooting"
authors = [
    { name = "RHEL Lightspeed" }
]
readme = "README.md"
requires-python = ">=3.10"
# Be careful about specifying an upper bound (with < or =~) because
# with our renovate strategy of in-range-only, we won't be notified
# about updates to incompatible versions, even if the old version is
# no longer getting security fixes.
dependencies = [
    "asyncssh[bcrypt] >= 2.22.0",
    "fastmcp >=2.14.4, <2.14.6",
    "litellm>=1.80.16",
    "pydantic-settings >= 2.12.0",
    "pydantic >= 2.12.5",
    # pydocket is incompatible with newer versions of fakeredis.
    # This can be removed once pydocket releases a fix.
    # https://github.com/chrisguidry/docket/issues/388
    "fakeredis<2.35",
]
dynamic = ["version"]
license-files = ["LICENSE", "licenses/GPL-3.0.txt"]
classifiers = [
    "Development Status :: 5 - Production/Stable",
    "Environment :: Console",
    "Intended Audience :: Developers",
    "Intended Audience :: Information Technology",
    "Intended Audience :: System Administrators",
    "Natural Language :: English",
    "Operating System :: POSIX :: Linux",
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3.10",
    "Programming Language :: Python :: 3.11",
    "Programming Language :: Python :: 3.12",
    "Programming Language :: Python :: 3.13",
    "Programming Language :: Python :: 3.14",
    "Programming Language :: Python :: 3 :: Only",
    "Topic :: System :: Systems Administration",
    "Topic :: Utilities",
]

[project.optional-dependencies]
gssapi = ["gssapi >=1.11.1"]
gcp = ["google-cloud-aiplatform>=1.147.0"]

[project.urls]
"Source code" = "https://github.com/rhel-lightspeed/linux-mcp-server"
"Bug Tracker" = "https://github.com/rhel-lightspeed/linux-mcp-server/issues"
"Documentation" = "https://rhel-lightspeed.github.io/linux-mcp-server/"

[project.scripts]
linux-mcp-server = "linux_mcp_server.__main__:cli"

[dependency-groups]
dev = [
    "ipdb",
    "ipython",
    "shiv",
    {include-group = "lint"},
    {include-group = "test"},
]

lint = [
    "pyright",
    "ruff",
]

test = [
    "pytest-asyncio>=1.3.0",
    "pytest-cov>=7.0.0",
    "pytest-mock",
    "pytest-randomly",
    "pytest>=9.0.2",
]

docs = [
    "mkdocs>=1.6.1",
    "mkdocs-material>=9.7.1",
    "mkdocstrings[python]>=1.0.2",
]

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

[tool.hatch.version]
source = "vcs"

[tool.pytest.ini_options]
addopts = [
    "-r", "a",
    "--verbose",
    "--strict-markers",
    "--cov", "src",
    "--cov", "tests",
    "--cov-report", "html",
    "--cov-report", "term-missing:skip-covered",
    "--durations-min", "1",
    "--durations", "10",
    "--color", "yes",
    "--showlocals",
    "--pdbcls", "IPython.terminal.debugger:TerminalPdb",
]
asyncio_mode = "auto"
pythonpath = "src"
testpaths = ["tests"]
norecursedirs = ["tests/functional"]

[tool.coverage.run]
branch = true
data_file = "coverage/.data"
source = [
    "src",
    "tests",
    "src/linux_mcp_server/_vendor/__init__.py",
]
omit = [
    "src/linux_mcp_server/_vendor/*/*",
    ".venv/*"  # VS Code is including these files in reports for an unknown reason
]

[tool.coverage.report]
exclude_lines = [
    "pragma: no cover",
    "def __repr__",
    "raise AssertionError",
    "raise NotImplementedError",
    "if __name__ == .__main__.:",
]

[tool.coverage.html]
directory = "coverage/htmlcov"

[tool.coverage.json]
output = "coverage/coverage.json"

[tool.coverage.xml]
output = "coverage/coverage.xml"

[tool.gha-update]
tag-only = [
    "actions/checkout",
    "actions/deploy-pages",
    "actions/download-artifact",
    "actions/setup-python",
    "actions/upload-artifact",
    "actions/upload-pages-artifact",
    "astral-sh/setup-uv",
    "codecov/codecov-action",
    "pypa/gh-action-pypi-publish",
    "softprops/action-gh-release",
]

[tool.pyright]
include = [
    "src",
    "tests",
]
ignore = [
    "src/linux_mcp_server/_vendor/*/*"
]
pythonVersion = "3.10"

[tool.ruff]
line-length = 120
indent-width = 4

[tool.ruff.lint]
# https://docs.astral.sh/ruff/rules/
# Enable ruff rules to act like flake8
select = [
    "E",  # pycodestyle (formerly part of flake8)
    "F",  # pyflakes (formerly part of flake8)
    "I",  # import order (like isort)
    # "B",  # flake8-bugbear
    "C90",  # flake8-comprehensions
    "RUF100",  # unused-noqa
    "T20",  # flake8-print
]
mccabe.max-complexity = 12

# Exclude specific rules if needed
ignore = [
    "E501",  # Ignore line length (similar to flake8's max-line-length)
]

[tool.ruff.lint.per-file-ignores]
"scripts/*" = ["T201"]
"tests/functional/*" = ["T201", "C901"]

[tool.ruff.lint.isort]
case-sensitive = false
force-single-line = true
lines-after-imports = 2
lines-between-types = 1
order-by-type = false

# Include the bundled mcp app html file
[tool.hatch.build.targets.wheel.force-include]
"mcp-app/dist" = "linux_mcp_server/ui_resources"

# Force hatch to pick up the bundled app that is git-ignored
[tool.hatch.build]
artifacts = [
    "mcp-app/dist",
]