framework-mcp

Entfernter MCP-Server, der Coding-Agenten (Claude Code, Cursor usw.) verifizierte, versionsgebundene Antworten zu schnelllebigen Frameworks liefert – beginnend mit Expo SDK 54.

Warum: LLM-Trainingsdaten veralten schneller als die Release-Zyklen von Frameworks. Die Agenten raten weiterhin dieselben versionsspezifischen Fragen, anstatt eine verifizierte, versionsgebundene Quelle zu prüfen. Dieser Server ist diese Quelle.

Stack

Node 24 + TypeScript, @modelcontextprotocol/sdk über Express, Postgres (pg), über die eigene requireBearerAuth-Middleware des SDKs.

Hosting: Railway (Compute, ~$5/Monat Hobby-Plan) + Neon (Postgres, kostenloser Tarif, mit Branch-Unterstützung).

Lokale Einrichtung

1. Erstelle ein kostenloses Neon-Konto und -Projekt. Kopiere den Verbindungsstring für einen dev-Branch.

2. cp .env.example .env ausführen und DATABASE_URL (von Neon) und API_KEY_PEPPER ausfüllen (eine beliebige lange Zufallszeichenfolge – erzeuge sie mit node -e "console.log(require('crypto').randomBytes(32).toString('hex'))").

3. Installieren, migrieren, seeden, bauen:

   npm install
   npm run db:migrate
   npm run db:seed
   npm run build

4. Lege dir einen API-Schlüssel an:

   npm run create-api-key -- "my laptop"

   Das gibt den Rohschlüssel einmalig aus – speichere ihn, er ist nicht wiederherstellbar.

5. Lokal ausführen:

   npm run dev

   curl http://localhost:3000/health sollte ok zurückgeben.

Mit dem MCP Inspector verifizieren

npx @modelcontextprotocol/inspector

Verbinde dich mit http://localhost:3000/mcp mit dem Transport „Streamable HTTP" und setze in den Verbindungseinstellungen den Header Authorization: Bearer <your-api-key>. Bestätige, dass alle 3 Tools (ping, query_framework_doc, report_outcome) aufgelistet und aufrufbar sind.

Auf Railway bereitstellen

1. curl -fsSL agents.railway.com | sh ausführen und dann railway login.

2. Von diesem Repository aus: railway init (oder railway link, falls bereits ein Projekt existiert).

3. Umgebungsvariablen setzen (Dashboard oder railway variable set KEY=value): DATABASE_URL (Verbindungsstring der Neon-Produktions-Branch, getrennt von der Dev-Branch), API_KEY_PEPPER, NODE_ENV=production.

4. railway up ausführen.

5. Im Railway-Dashboard: Settings → Networking → Generate Domain. Setze PUBLIC_HOSTNAME auf diese Domain (nötig für den DNS-Rebinding-Host-Check des SDKs, um echten Traffic zuzulassen).

6. Führe npm run db:migrate && npm run db:seed einmal gegen die Produktions-DATABASE_URL aus (von deinem Rechner aus, mit dem Produktions-Verbindungsstring).

7. Erstelle einen Produktions-API-Schlüssel mit npm run create-api-key, der auf die Produktions-DATABASE_URL zeigt.

API-Schlüssel erhalten

Self-Service: Besuch https://framework-mcp-production.up.railway.app/, E-Mail eintragen, sofort Schlüssel erhalten (ein aktiver Schlüssel pro E-Mail, ratenbegrenzt).

Fallback für Maintainer/lokal: npm run create-api-key -- "label".

Remote-Client verbinden

In einer .mcp.json für Claude Code:

{
  "mcpServers": {
    "framework-mcp": {
      "type": "http",
      "url": "https://<your-railway-domain>/mcp",
      "headers": { "Authorization": "Bearer <your-api-key>" }
    }
  }
}

Tools

• ping(message) – Gesundheitscheck

• query_framework_doc(framework, version, question) – sucht eine verifizierte Antwort, gibt query_id zurück

• report_outcome(query_id, worked, note?) – protokolliert, ob die zurückgegebene Antwort tatsächlich funktioniert hat

Status

Seed-Daten in db/seed/expo-54.json (20 Einträge), verifiziert am 2026-08-21 gegen https://expo.dev/changelog/sdk-54 und https://docs.expo.dev/modules/autolinking/.

Self-Service-Registrierung live unter / (E-Mail -> sofortiger API-Schlüssel, ein Schlüssel pro E-Mail, IP-ratenbegrenzt). Gelistet auf Smithery / Glama / mcp.so.

Zurückgestellt (Phase B, noch nicht umgesetzt): Stripe-Abrechnung, plan_tier / credit_balance / Rate-Limit-Durchsetzung pro Schlüssel auf api_keys, weitere Frameworks, Scoring/Ranking auf Feedback.