feat: initial homelab-mcp-gitea v0.1

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.

This commit is contained in:

homelab-mcp

2026-07-22 12:47:59 +00:00

commit 0212913831

12 changed files with 2218 additions and 0 deletions

									
										src/homelab_mcp_gitea/__init__.py
									
		+2
		
												View File
												
				@@ -0,0 +1,2 @@

				def main() -> None:

				    print("Hello from homelab-mcp-gitea!")