torben
18ae28f918
Chemenu kompiliert Rohnotizen zu einem verlinkten, quellengebundenen Wiki: raw/ -> types/ + tools/ -> kb/ -> reports/. Was mechanisch ist, macht tools/wikitool; was Urteil braucht, macht ein Agent unter Contracts, deren Grenzen in Code durchgesetzt sind statt im Prompt. Dieser Commit ist der Startpunkt der oeffentlichen Historie. Die vorherige Entwicklung fand in einer privaten Instanz statt und ist nicht Teil dieses Repositorys; ihre Erzaehlung steht vollstaendig in CHANGES.md, das mit 44 Eintraegen von 0.1.0 bis 2.1.0 erhalten geblieben ist. Der mitgelieferte Korpus ist ein Testbett und eine Demo: 170 Seiten ueber den Stack selbst - Gates, Lint, Versionierung, Suche, das Wiki-Muster. Er dokumentiert das Werkzeug mit den eigenen Mitteln des Werkzeugs. Lizenz: AGPL-3.0 fuer den Stack (tools/, types/), CC-BY-4.0 fuer die Inhalte. Die Grenze zwischen beiden ist der Dateiplan, den dist export berechnet - siehe NOTICE.
103 lines
5.0 KiB
Markdown
103 lines
5.0 KiB
Markdown
---
|
|
type: types/entity.md
|
|
entity_type: tool
|
|
tags: [gitea, mcp, ci-cd, diagnostics]
|
|
created: 2026-08-30
|
|
modified: 2026-08-31
|
|
related: [Gitea Actions, Issue Label Scheme]
|
|
sources: [Source - Conversation - Versioning CI-CD and Content Migration Session 2026-08-30, Source - Conversation - Issue Triage Labels and TODO Retirement Session 2026-08-31]
|
|
confidence: 0.70
|
|
confidence_base: 0.70
|
|
provenance: sourced
|
|
summary: MCP-Server fuer die Gitea-API; liest Actions-Laeufe, Logs, Releases und Issues, ist bei privatem Repository der einzige belastbare Blick auf den CI-Zustand und traegt seit 2026-08-31 auch die Board-Triage
|
|
---
|
|
# Gitea MCP Server
|
|
|
|
**Typ:** Tool
|
|
|
|
## Beschreibung
|
|
|
|
Der Gitea MCP Server stellt die Gitea-API als MCP-Werkzeuge bereit und erlaubt einem Agenten
|
|
damit den lesenden und schreibenden Zugriff auf Repositories, Actions-Läufe samt Logs, Releases,
|
|
Tags, Issues und Pull Requests. Er wurde in der Sitzung vom 2026-08-30 verfügbar gemacht,
|
|
nachdem die Fehlersuche an der CI-Pipeline von außen an eine Wand gelaufen
|
|
war[^s-conversation-versioning-ci-cd-and-content-migration-session-2026-08-30].
|
|
|
|
Seine praktische Bedeutung in dieser Installation ergibt sich aus einer Eigenschaft des
|
|
Origin-Repositories: Es ist privat, und [[Gitea]] antwortet einem anonymen Aufrufer mit einem
|
|
identischen `404` für ein unsichtbares und für ein nicht existierendes
|
|
Repository[^s-conversation-versioning-ci-cd-and-content-migration-session-2026-08-30]. Ein
|
|
`curl` gegen die API beweist deshalb nichts, und aus einem `404` lässt sich kein Rückschluss auf
|
|
den CI-Zustand ziehen. Der MCP-Server ist der Weg, auf dem Läufe tatsächlich gelesen werden.
|
|
|
|
## Kerndaten
|
|
|
|
- **Zweck:** Gitea-API als MCP-Werkzeuge; Diagnose von Actions-Läufen, Verwaltung von Issues und
|
|
Releases
|
|
- **Status:** Aktiv, in Gebrauch seit 2026-08-30
|
|
- **Angebunden an:** die [[Gitea]]-Instanz, die die Repositories und [[Gitea Actions]] betreibt
|
|
- **Zugriffsart:** authentifiziert - anders als ein anonymer HTTP-Aufruf sieht er private
|
|
Repositories
|
|
|
|
## Beziehungen
|
|
|
|
- **Verwendet:** [[Gitea]]-API
|
|
- **Liest:** Läufe und Logs von [[Gitea Actions]], ausgeführt vom [[Act Runner]]
|
|
- **Verwendet von:** [[Chemenu]] zur Diagnose der eigenen Pipeline
|
|
- **setzt um:** [[Issue Label Scheme]]
|
|
|
|
## Details
|
|
|
|
### Verwendung in der Fehlersuche
|
|
|
|
Die erste Diagnose über den Server war schreibgeschützt und drehte die stehende Annahme um:
|
|
`list_runs` lieferte sechs Läufe, die Läufe 46-51 alle mit `conclusion: failure`, und die Logs
|
|
nannten den Grund konkret[^s-conversation-versioning-ci-cd-and-content-migration-session-2026-08-30]:
|
|
|
|
```
|
|
OCI runtime exec failed: exec: "node": executable file not found in $PATH
|
|
❌ Failure - Main actions/checkout@v4
|
|
exitcode '127': command not found
|
|
```
|
|
|
|
Die Runner hatten die Workflows also die ganze Zeit angenommen. Der Befund „die Runner laufen
|
|
nicht" war von außen nicht überprüfbar gewesen und falsch. Details zur Ursache auf der Seite
|
|
[[Act Runner]].
|
|
|
|
### Anwendungsfälle in dieser Installation
|
|
|
|
- Actions-Läufe auflisten, ihren Ausgang und ihre Logs lesen
|
|
- Releases prüfen, die `release.yml` erzeugt hat, samt hochgeladener Assets
|
|
- Issues anlegen und pflegen - die offenen Ausbaustufen der CI/CD-Arbeit liegen als Gitea-Issues
|
|
statt als Prosa in `TODO.md`[^s-conversation-versioning-ci-cd-and-content-migration-session-2026-08-30].
|
|
Seit der Löschung von `TODO.md` am 2026-08-31 ist das Board die einzige Ablage offener
|
|
Arbeit[^s-conversation-issue-triage-labels-and-todo-retirement-session-2026-08-31]
|
|
- Ein ganzes Board triagieren: Beim Priorisierungslauf vom 2026-08-31 wurden elf Issue-Texte
|
|
über den Server gelesen statt aus den Titeln erschlossen, danach sieben Labels angelegt und
|
|
auf alle zehn offenen Issues angewandt[^s-conversation-issue-triage-labels-and-todo-retirement-session-2026-08-31]
|
|
- `list_runs` als Beweismittel: Die Beobachtung, dass zu Commit `f916376` kein Lauf existiert,
|
|
schloss Gitea-Issue #11, ohne dass eine Zeile Code geschrieben wurde[^s-conversation-issue-triage-labels-and-todo-retirement-session-2026-08-31]
|
|
|
|
## Historie
|
|
|
|
- [2026-08-31] - Trägerwerkzeug der ersten Board-Triage: elf Issue-Texte gelesen, sieben Labels
|
|
nach dem [[Issue Label Scheme]] angelegt und angewandt, #11 geschlossen, #14 und #15
|
|
eröffnet[^s-conversation-issue-triage-labels-and-todo-retirement-session-2026-08-31]
|
|
- [2026-08-30] - Verfügbar gemacht und erstmals eingesetzt; die Diagnose der bis dahin
|
|
unerklärten CI-Fehlschläge lief vollständig über ihn
|
|
- [2026-08-30] - Seite beim Ingest des Sitzungstranskripts erstellt
|
|
|
|
## Siehe auch
|
|
|
|
- [[Gitea]]
|
|
- [[Gitea Actions]]
|
|
- [[Act Runner]]
|
|
- [[Chemenu]]
|
|
- [[Issue Label Scheme]]
|
|
- [[Source - Conversation - Issue Triage Labels and TODO Retirement Session 2026-08-31]]
|
|
|
|
## Fußnoten
|
|
|
|
[^s-conversation-versioning-ci-cd-and-content-migration-session-2026-08-30]: [[Source - Conversation - Versioning CI-CD and Content Migration Session 2026-08-30]]
|
|
[^s-conversation-issue-triage-labels-and-todo-retirement-session-2026-08-31]: [[Source - Conversation - Issue Triage Labels and TODO Retirement Session 2026-08-31]]
|