Skolverket MCP Server

# 🔄 Auto-Deploy Konfiguration

Detta dokument beskriver hur automatisk deployment fungerar för Skolverket MCP.

## 📦 Deployment Pipeline

```
Git Tag (v2.1.x) → GitHub Action → npm → MCP Registry
                                          ↓
Git Push → Render Auto-Deploy
```

## 🚀 Plattformar

### 1. npm Registry

**Status:** ✅ Auto-deploy via GitHub Actions

**Trigger:** När du pushar en ny Git tag (format: `v*.*.*`)

**Workflow:** `.github/workflows/publish-npm.yml`

**Steg:**
1. Checkout kod
2. Installera dependencies (`npm ci`)
3. Bygga projektet (`npm run build`)
4. Publicera till npm (`npm publish`)

**Krav:**
- npm Access Token måste sättas som GitHub Secret: `NPM_TOKEN`

**Så här sätter du NPM_TOKEN:**
1. Gå till https://www.npmjs.com/settings/[ditt-användarnamn]/tokens
2. Klicka "Generate New Token" → "Classic Token"
3. Välj "Automation"
4. Kopiera token
5. Gå till GitHub Repo → Settings → Secrets and variables → Actions
6. Klicka "New repository secret"
7. Name: `NPM_TOKEN`
8. Value: [din token]

### 2. MCP Registry

**Status:** ✅ Auto-deploy via GitHub Actions

**Trigger:** Körs automatiskt efter framgångsrik npm-publicering

**Workflow:** `.github/workflows/publish-mcp-registry.yml`

**Steg:**
1. Väntar på att npm-workflow slutförs
2. Installerar `mcp-publisher` CLI
3. Loggar in med GitHub
4. Publicerar till MCP Registry

**Krav:**
- Använder `GITHUB_TOKEN` (automatiskt tillgänglig i Actions)

### 3. Render

**Status:** ✅ Auto-deploy från GitHub (om konfigurerat)

**Trigger:** När kod pushas till `master`-branchen

**Konfiguration:**
Verifiera att auto-deploy är aktiverat:
1. Gå till https://dashboard.render.com/
2. Välj din service: `skolverket-mcp`
3. Gå till **Settings** → **Build & Deploy**
4. Kontrollera att **Auto-Deploy** är **YES**

Om auto-deploy INTE är aktiverat:
1. Klicka på **Auto-Deploy**-inställningen
2. Välj **YES**
3. Spara

### 4. AlternativeTo

**Status:** ⚪ Manuell (community-driven plattform)

AlternativeTo kräver manuell uppdatering av mjukvaruinformation via deras webbgränssnitt.

## 📝 Användning

### Publicera en ny version

1. **Uppdatera version:**
   ```bash
   # Redigera package.json och server.json
   # Uppdatera CHANGELOG.md
   ```

2. **Committa ändringar:**
   ```bash
   git add package.json server.json CHANGELOG.md
   git commit -m "chore: Bump version to 2.1.3"
   git push origin master
   ```

3. **Skapa och pusha tag:**
   ```bash
   git tag v2.1.3
   git push origin v2.1.3
   ```

4. **GitHub Actions gör resten:**
   - Publicerar till npm automatiskt
   - Publicerar till MCP Registry automatiskt
   - Render deployas automatiskt (från `master` push)

### Manuell override

Om något går fel kan du alltid köra manuellt:

```bash
# npm
npm run build && npm publish

# MCP Registry
mcp-publisher login github
mcp-publisher publish

# Render
# Gå till dashboard och klicka "Manual Deploy"
```

## 🔍 Verifiera Deployment

### Kontrollera npm
```bash
npm info skolverket-mcp version
```

### Kontrollera MCP Registry
```bash
curl -I https://registry.modelcontextprotocol.io/servers/io.github.KSAklfszf921/skolverket-mcp
```

### Kontrollera Render
```bash
curl -s https://skolverket-mcp.onrender.com/health | jq .version
```

## ⚙️ GitHub Actions Status

Du kan följa deployment-status i GitHub:

**URL:** https://github.com/KSAklfszf921/Skolverket-MCP/actions

Varje push och tag-skapande triggar workflows som visas här.

## 🚨 Felsökning

### npm-publicering misslyckas
- Kontrollera att `NPM_TOKEN` är satt korrekt
- Verifiera att token har `Automation` permissions
- Kolla att `package.json` version är högre än nuvarande

### MCP Registry-publicering misslyckas
- Kontrollera att npm-steget slutfördes framgångsrikt först
- Verifiera att `server.json` finns och är korrekt formaterat
- Logga `GITHUB_TOKEN` har rätt permissions

### Render deployas inte
- Kontrollera att Auto-Deploy är aktiverat i Render dashboard
- Verifiera att GitHub-connection är aktiv
- Kolla Render logs för fel

## 📚 Mer Information

- [npm Publishing Guide](https://docs.npmjs.com/cli/v9/commands/npm-publish)
- [MCP Registry Guide](https://github.com/modelcontextprotocol/registry)
- [GitHub Actions Documentation](https://docs.github.com/en/actions)
- [Render Auto-Deploy](https://render.com/docs/deploys)