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

									
										.env.example
									
		+3
		
												View File
												
				@@ -0,0 +1,3 @@

				# Copy to .env and fill in. The server reads these on every tool call.

				GITEA_URL=https://gitlab.impresion3d.pro

				GITEA_TOKEN=replace-with-your-40-char-personal-access-token