# Gitea MCP Server

שרת MCP (Model Context Protocol) לגיטאה — מאפשר ניהול מלא של ריפוזיטוריות, issues, pull requests, wikis, actions ועוד דרך Claude Code וכלי MCP אחרים.

**תומך בחיבור לכמה שרתי Gitea במקביל.**

## התקנה מהירה

```bash
curl -fsSL https://gitea.dev.marcus-law.co.il/mcp-servers/gitea-mcp/raw/branch/main/install.sh | bash
```

הסקריפט:
- משכפל את הריפו ל-`~/.gitea-mcp`
- בונה בינארי ומתקין ל-`$GOPATH/bin`
- מגדיר MCP server גלובלי ב-`~/.claude/settings.json`
- מאפשר הוספת שרתים נוספים באופן אינטראקטיבי
- מוחק הגדרות כפולות מקבצי `.mcp.json` ברמת פרויקט

### דרישות מוקדמות

- [Go](https://go.dev) 1.24+
- git
- jq

### שדרוג

אותה פקודה בדיוק — הסקריפט מזהה התקנה קיימת ומעדכן:

```bash
curl -fsSL https://gitea.dev.marcus-law.co.il/mcp-servers/gitea-mcp/raw/branch/main/install.sh | bash
```

## הגדרה ידנית

> **חשוב:** כדי שההגדרה תהיה **גלובלית** (זמינה בכל פרויקט), יש לכתוב אותה ב-`~/.claude/settings.json` תחת `mcpServers`.
> אל תשתמשו ב-`.mcp.json` ברמת פרויקט — זה יגרום לכפילויות ויעבוד רק בתיקייה הספציפית.

### שרת יחיד

```json
{
  "mcpServers": {
    "gitea-dev": {
      "command": "gitea-mcp",
      "args": ["-t", "stdio", "--host", "https://gitea.example.com"],
      "env": {
        "GITEA_ACCESS_TOKEN": "<token>"
      }
    }
  }
}
```

### כמה שרתים

הוסף את `GITEA_SERVERS` כ-JSON object עם שם → `{host, token, insecure}`:

```json
{
  "mcpServers": {
    "gitea-dev": {
      "command": "gitea-mcp",
      "args": ["-t", "stdio", "--host", "https://gitea.example.com"],
      "env": {
        "GITEA_ACCESS_TOKEN": "<default-token>",
        "GITEA_SERVERS": "{\"prod\":{\"host\":\"https://gitea.prod.example.com\",\"token\":\"<prod-token>\"},\"staging\":{\"host\":\"https://staging.example.com\",\"token\":\"<staging-token>\",\"insecure\":true}}"
      }
    }
  }
}
```

כל כלי מקבל פרמטר `server` אופציונלי:

```
list_my_repos                     # ברירת מחדל
list_my_repos(server: "prod")     # שרת ספציפי
list_servers                      # הצג שרתים מוגדרים
```

## משתני סביבה

| משתנה | תיאור |
|---|---|
| `GITEA_ACCESS_TOKEN` | טוקן גישה לשרת ברירת המחדל |
| `GITEA_HOST` | כתובת שרת ברירת המחדל |
| `GITEA_SERVERS` | JSON object של שרתים נוספים |
| `GITEA_READONLY` | `true` להצגת כלי קריאה בלבד |
| `GITEA_DEBUG` | `true` למצב debug |
| `GITEA_INSECURE` | `true` לדלג על בדיקת TLS |
| `MCP_MODE` | `stdio` (ברירת מחדל) או `http` |

## כלים זמינים

השרת מספק 60+ כלי MCP:

| תחום | כלים |
|---|---|
| משתמש | `get_me`, `get_user_orgs` |
| ריפוזיטוריות | `create_repo`, `fork_repo`, `list_my_repos`, `list_org_repos`, `get_repo`, `repo_write`, `list_forks` |
| ענפים | `list_branches`, `create_branch`, `delete_branch`, `branch_protection_read/write` |
| תגיות | `list_tags`, `get_tag`, `create_tag`, `delete_tag` |
| קבצים | `get_file_contents`, `get_dir_contents`, `create_or_update_file`, `delete_file`, `get_repository_tree` |
| קומיטים | `list_commits`, `get_commit`, `get_compare` |
| Issues | `list_issues`, `issue_read`, `issue_write`, `search_issues` |
| Pull Requests | `list_pull_requests`, `pull_request_read`, `pull_request_write`, `pull_request_review_write` |
| Labels | `label_read`, `label_write` |
| Milestones | `milestone_read`, `milestone_write` |
| Releases | `list_releases`, `get_release`, `get_latest_release`, `create_release`, `delete_release` |
| Wiki | `wiki_read`, `wiki_write` |
| מעקב זמן | `timetracking_read`, `timetracking_write` |
| Actions | `actions_run_read`, `actions_run_write`, `actions_config_read`, `actions_config_write` |
| התראות | `notification_read`, `notification_write` |
| ארגונים | `org_read`, `org_write` |
| Webhooks | `webhook_read`, `webhook_write` |
| Collaborators | `collaborator_read`, `collaborator_write` |
| Deploy Keys | `deploy_key_read`, `deploy_key_write` |
| Topics | `topic_read`, `topic_write` |
| חיפוש | `search_users`, `search_repos`, `search_org_teams` |
| שרת | `get_gitea_mcp_server_version`, `list_servers` |

## פיתוח

```bash
make build        # בנייה
make install      # בנייה + התקנה ל-GOPATH/bin
make dev          # hot reload (דורש air)
make clean        # ניקוי
go test ./...     # טסטים
```

## רישיון

MIT