cursor_Setup
This commit is contained in:
1 parent
c607cd1833
commit
dc87e7f3b8
13 files changed
+1328
No files matched your search
@@ -0,0 +1,64 @@
|
||||
# Gitea MCP-Server für Cursor
|
||||
|
||||
Damit der Agent **strukturierte Tools** nutzen kann (`gitea_list_issues`, `gitea_close_issue`, …), registrierst du diesen MCP-S **lokal** in Cursor.
|
||||
|
||||
## 1. Abhängigkeit
|
||||
|
||||
```powershell
|
||||
pip install -r scripts/gitea/requirements-mcp.txt
|
||||
```
|
||||
|
||||
Oder: `pip install "mcp>=1.2.0"`
|
||||
|
||||
## 2. Secrets
|
||||
|
||||
Wie beim CLI: **`GITEA_*` in der Repo-Root `.env`** (wird von `gitea_lib` geladen), **oder** dieselben Variablen in der MCP-`env` (siehe unten).
|
||||
|
||||
**Niemals** Tokens in Git committen.
|
||||
|
||||
## 3. Cursor MCP konfigurieren
|
||||
|
||||
**Variante A – UI:** Einstellungen → **MCP** / Tools → Server hinzufügen → Typ „Command“:
|
||||
|
||||
- **Command:** `python` (oder voller Pfad zu `python.exe`)
|
||||
- **Args:** vollständiger Pfad zu `mcp_server_gitea.py`, z. B.
|
||||
`C:\Dev\mitai-jinkendo\scripts\gitea\mcp_server_gitea.py`
|
||||
- **Working directory (optional):** `C:\Dev\mitai-jinkendo\scripts\gitea`
|
||||
- **Env:** nur nötig, wenn du **keine** `.env` im Repo nutzt:
|
||||
|
||||
```text
|
||||
GITEA_BASE_URL=http://192.168.2.144:3000
|
||||
GITEA_OWNER=Lars
|
||||
GITEA_REPO=mitai-jinkendo
|
||||
GITEA_TOKEN=…
|
||||
```
|
||||
|
||||
**Variante B – JSON:** Datei `~/.cursor/mcp.json` (Benutzer) oder projektbezogen laut Cursor-Doku. Beispielinhalt siehe **`.cursor/mcp.json.example`** im Repo (Platzhalter, ohne echtes Token).
|
||||
|
||||
Cursor nach Änderung **vollständig neu starten**.
|
||||
|
||||
## 4. Netzwerk
|
||||
|
||||
Die Gitea-URL muss von deinem Rechner erreichbar sein (z. B. `192.168.2.144:3000` im LAN).
|
||||
|
||||
## 5. Repo-Zugriff
|
||||
|
||||
- **API:** Tool `gitea_get_repo_file` (Dateiinhalt / Metadaten).
|
||||
- **Git (lokal):** unverändert `git pull` / Agent liest Workspace-Dateien – dafür brauchst du kein MCP.
|
||||
|
||||
## Bereitgestellte Tools (Kurzüberblick)
|
||||
|
||||
| Tool | Zweck |
|
||||
|------|--------|
|
||||
| `gitea_list_issues` | Issues listen, optional alle Seiten |
|
||||
| `gitea_get_issue` | Ein Issue mit Body |
|
||||
| `gitea_comment_issue` | Kommentar |
|
||||
| `gitea_create_issue` | Neu anlegen |
|
||||
| `gitea_close_issue` / `gitea_reopen_issue` | Status |
|
||||
| `gitea_get_repo_file` | Datei remote via API |
|
||||
|
||||
## Issue-Triage durch den Agent
|
||||
|
||||
Sinnvoller Ablauf: Issues listen → je Issue **Code/Commits prüfen** → bei eindeutig erledigt: kurzer Kommentar + **close**; bei teilweise: Kommentar mit Checkboxen; bei unklar: nur Kommentar, **nicht** schließen.
|
||||
|
||||
Autonom alles schließen ist fehleranfällig; klare Regeln oder manuelle Freigabe für `close` empfohlen.
|
||||
Reference in new issue
Block a user