homelab-mcp
0212913831
MCP server exposing self-hosted Gitea (gitlab.impresion3d.pro) via stdio JSON-RPC 2.0. Six tools: list_repos, get_repo, get_file, create_issue, list_open_prs, merge_pr. The merge_pr tool pins the Gitea 'do'-field trap (see skill gitea pitfall #13) — sends lowercase 'do', treats HTTP 200 with non-empty body as failure. Stack: FastMCP + httpx + pydantic + uv, with respx-mocked pytest suite (15 tests, 0.69s) and ruff + mypy strict green. Verification: scripts/verify_stdio.py boots the server as a subprocess, exchanges real MCP messages over stdio, and calls list_repos against the live Gitea instance — all green.
50 lines
1005 B
TOML
50 lines
1005 B
TOML
[project]
|
|
name = "homelab-mcp-gitea"
|
|
version = "0.1.0"
|
|
description = "MCP server that exposes a self-hosted Gitea instance to MCP-aware clients"
|
|
readme = "README.md"
|
|
requires-python = ">=3.11"
|
|
dependencies = [
|
|
"httpx>=0.27",
|
|
"mcp[cli]>=1.2",
|
|
"pydantic>=2.7",
|
|
]
|
|
|
|
[project.scripts]
|
|
homelab-mcp-gitea = "homelab_mcp_gitea.server:main"
|
|
|
|
[dependency-groups]
|
|
dev = [
|
|
"pytest>=8.3",
|
|
"pytest-asyncio>=0.24",
|
|
"pytest-cov>=6",
|
|
"ruff>=0.7",
|
|
"mypy>=1.13",
|
|
"respx>=0.21",
|
|
]
|
|
|
|
[build-system]
|
|
requires = ["hatchling"]
|
|
build-backend = "hatchling.build"
|
|
|
|
[tool.hatch.build.targets.wheel]
|
|
packages = ["src/homelab_mcp_gitea"]
|
|
|
|
[tool.ruff]
|
|
line-length = 100
|
|
target-version = "py311"
|
|
|
|
[tool.ruff.lint]
|
|
select = ["E", "F", "W", "I", "N", "UP", "B", "SIM", "RUF"]
|
|
ignore = ["E501"]
|
|
|
|
[tool.mypy]
|
|
python_version = "3.11"
|
|
strict = true
|
|
warn_unused_ignores = true
|
|
disallow_untyped_defs = true
|
|
|
|
[tool.pytest.ini_options]
|
|
addopts = "-ra --strict-markers"
|
|
asyncio_mode = "auto"
|
|
testpaths = ["tests"] |