SME Library MCP

Ein kostenloser, Open-Source-MCP-Server für das Erstellen, Suchen und Teilen von SME-Profilen (Subject-Matter-Expert-Profile), die KI-Agenten abrufen können. Jeder kann seinen Agenten verbinden, geprüfte Experten aus der gemeinsamen Bibliothek abrufen, private Experten im eigenen Workspace pflegen und gute Profile über eine moderierte Promotions-Pipeline beitragen – oder den gesamten Stack selbst hosten.

Lizenziert unter der MIT-Lizenz. Beiträge sind über Issues und Pull Requests willkommen.

Läuft auf Vercel (Next.js + Streamable-HTTP-Transport) mit einem Supabase-Backend. Neu hier? Lies das Benutzerhandbuch – wie alles funktioniert, plus eine vollständige Referenz für jedes SME-Feld und seine Wertbereiche (auch in der App unter /guide). Siehe ARCHITECTURE.md für das vollständige Design und die Roadmap sowie docs/SME_MCP_Implementation_Checklist.pdf für das Schritt-für-Schritt-Deployment-Runbook (neu generierbar aus docs/implementation-checklist.html).

Tools

Related MCP server: HiveMind

Setup

1. Supabase

Ein Projekt erstellen, dann the Migration anwenden:

supabase link --project-ref <ref>
supabase db push                    # applies supabase/migrations/*.sql
supabase functions deploy embed     # optional: enables semantic/hybrid search

Die embed-Edge-Funktion nutzt das eingebaute gte-small-Modell. Sie ist optional – ohne sie fällt die Suche automatisch auf die Stichwort-FTS (Volltextsuche) zurück.

2. Einen API-Schlüssel erhalten

Self-Service (empfohlen): /dashboard besuchen), ein Konto erstellen (Supabase Auth) and sendieren: Der innere Login erstellt automatisch deinen Workspace. Erfordert, dass SUPABASE_ANON_KEY gesetzt is und E-Mail-Auth im Supabase-Projekt aktiviert ist.

Operator / CLI: für Admin-Schlüssel oder skriptbasierte Bereitstellung:

SUPABASE_URL=... SUPABASE_SERVICE_ROLE_KEY=... \
  node scripts/create-key.mjs --workspace "My Team"            # read,write key
  node scripts/create-key.mjs --workspace "Ops" --admin        # admin key

In beiden Fällen wird der Klartext-Schlüssel (sme_live_...) nur einmal angezeigt; nur sein SHA-256-Hash wird gespeichert.

3. Auf Vercel bereitstellen (Deployment)

vercel deploy

Setze die Umgebungsvariablen im Vercel-Projekt fest: SUPABASE_URL, SUPABASE_SERVICE_ROLE_KEY, SUPABASE_ANON_KEY (für das Dashboard), ANTHROPIC_API_KEY und CRON_SECRET (schützt den täglichen /api/cron/maintenance-Job, der Qualitäts-Scores neu berechnet, Rate-Limit-Fenster bereinigt und Embeddings nachträgt). Setze außerdem NEXT_PUBLIC_BASE_URL auf die kanonische URL deiner Website und ADMIN_EMAILS (durch Kommas getrennt), um den Admin-Zugriff zu initialisieren.

3b. E-Mail (Bestätigungen & Passwort-Resets)

Auth-E-Mails werden von Supabase gesendet, nicht von dieser App. Wenn neue Konten keine Validierungs-E-Mails erhalten, liegt es an einer Supabase-Konfiguration – meistens daran, dass Custom SMTP nicht konfiguriert ist (der integrierte Absender ist auf ein paar E-Mails pro Stunde begrenzt, nur für Tests). Im Supabase-Dashboard: Authentication → Emails → SMTP Settings konfigurieren (Resend/Postmark/SendGrid/SES), Confirm email unter Providers → Email aktivieren und die eigene Website plus …/auth/callback zur URL Configuration Allow-List hinzufügen.

4. Einen Client verbinden

claude mcp add --transport http sme-library \
  https://<deployment>/api/mcp \
  --header "Authorization: Bearer sme_live_..."

Funktioniert mit Claude Code, claude.ai Custom Connectors und jedem Streamable-HTTP-MCP-Client.

Lokale Entwicklung

cp .env.example .env      # fill in Supabase + Anthropic
npm install
npm run dev               # HTTP server on :3000 (endpoint: /api/mcp)
SME_API_KEY=sme_live_... npm run stdio   # or stdio transport for local clients

Sicherheitsmodell

• API-Schlüssel werden im Ruhezustand gehasht (SHA-256) und nur über den Authorization-Header übergeben – die Anmeldedaten erscheinen keiner Tool-Argumenten noch im Modellkontext.

• Jeder Schlüssel ist einen Workspace mit Scopes (read, write, promote, admin) und einer Rate-Limit-Stufe zugeordnet; Pro-Schlüssel-Fixed-Window-Limits werden in Postgres durchgesetzt.

• Supabase RLS ist and jeder Tabelle als Defense-in-Depth mit Deny-All aktiviert; nur der Service-Role-Client des Servers kann lesen oder schreiben.

• Alle Schreibvorgänge landen in audit_log.