@prosodyai/mcp-docs

MCP-Server, der KI-Coding-Agenten die ProsodyAI-Dokumentation, SDK-Referenzen, REST-API-Referenz (OpenAPI) und kuratierte Implementierungsrezepte zur Verfügung stellt.

Entwickelt, damit ein externer Coding-Agent (z. B. AureliaStudio) ProsodyAI-Integrationen direkt beim ersten Mal korrekt implementieren kann, ohne die Website zu scrapen oder API-Strukturen zu erraten.

Wird mit zwei Transportwegen in einer einzigen TypeScript-Codebasis ausgeliefert:

• stdio — für lokale Agenten (Cursor, Claude Code, Cline, etc.)

• HTTP (Streamable HTTP) — für remote/gehostete Agenten

Verfügbare Tools

Jeder Eintrag wird auch als MCP-Ressource unter prosodyai://<section>/<id> für Clients bereitgestellt, die Ressourcen gegenüber Tools bevorzugen.

Enthaltene Rezepte

• recipes/sdk-typescript-quickstart — ProsodyAI zu einer Node / Next.js / Browser-App hinzufügen

• recipes/livekit-realtime-agent — Echtzeit-Sprachagent mit prosodiegesteuerter Anpassung

• recipes/langchain-agent — Prosody als LangChain-Tool verwenden

• recipes/browser-streaming — Mikrofon-Audio aus dem Browser streamen

• recipes/kpi-flow — Benutzerdefinierte KPIs definieren und den Feedback-Loop schließen

• recipes/rest-api-integration — Direkte REST-Integration ohne SDK

Lokal ausführen

npm install
npm run build         # syncs content/ from the monorepo, then compiles
npm run start:stdio   # for stdio MCP clients
npm run start:http    # http on localhost:3333/mcp

npm run build:content erstellt content/ aus dem übergeordneten Monorepo neu. Es lokalisiert das Monorepo über PROSODYAI_REPO_ROOT oder durch Suchen im Verzeichnisbaum oberhalb dieses Pakets (funktioniert, wenn es als packages/mcp-docs im übergeordneten Monorepo eingebunden ist).

Verwendung mit AureliaStudio (oder einem beliebigen MCP-Client)

Stdio (lokal)

Zum mcp.json Ihres Clients hinzufügen:

{
  "mcpServers": {
    "prosodyai-docs": {
      "command": "npx",
      "args": ["-y", "@prosodyai/mcp-docs"]
    }
  }
}

Oder aus einem Checkout ausführen:

{
  "mcpServers": {
    "prosodyai-docs": {
      "command": "node",
      "args": ["/abs/path/to/mcp-docs/dist/stdio.js"]
    }
  }
}

HTTP (remote)

Sobald bereitgestellt (siehe unten), verweisen Sie Ihren Client auf die öffentliche URL:

{
  "mcpServers": {
    "prosodyai-docs": {
      "url": "https://prosodyai-docs.vercel.app/mcp"
    }
  }
}

Bereitstellung

Der HTTP-Einstiegspunkt ist eine einfache express-App, die auf PORT (Standard 3333) unter dem Pfad /mcp lauscht. Sie funktioniert auf jedem Node-Host:

• Vercel / Cloud Run / Fly / Railway: Als Node-Service bereitstellen, mit npm run build als Build-Schritt und npm run start:http als Startbefehl.

• Docker: siehe Dockerfile (einstufiges Node 20-slim Image).

/healthz gibt einen JSON-Heartbeat für Container-Orchestratoren zurück.

Inhalte aktualisieren

Immer wenn sich die Dokumentation, SDK-READMEs oder die OpenAPI-Spezifikation des übergeordneten Monorepos ändern:

cd packages/mcp-docs    # or wherever this is mounted
npm run build:content
git add content/ && git commit -m "Sync docs from monorepo"

Die nächste Bereitstellung liefert die neuen Inhalte aus. (CI im master-Branch von ProsodyAI/prosodyai sollte dies automatisch ausführen — siehe .github/workflows/sync.yml, falls vorhanden.)

Lizenz

MIT