Skip to main content
Glama
Crescender MCP Server

Crescender MCP Server

by lincalinca

Crescender MCP-Server

Model Context Protocol-Server für die öffentliche Lese-API von Crescender. Verbindet KI-Clients (Claude Desktop, Cursor, benutzerdefinierte Agenten) mit den Ressourcen, Ausleihen, Mitgliedern und Asset-Kommunikations-Threads einer Schule – alles schreibgeschützt, per Scope-Token authentifiziert und pro Token an eine einzige Schule gebunden.

Status: 0.0.x — vor der Veröffentlichung. Dieses Paket wurde noch nicht auf npm veröffentlicht oder in die GHCR gepusht. Die Veröffentlichungs-Pipelines existieren, sind aber auf manuelle Auslösung beschränkt; die erste Version erscheint, sobald der Quellcode lokal auf Herz und Nieren geprüft wurde. Führen Sie das Programm vorerst über einen Klon oder pnpm link aus (siehe Lokale Entwicklung unten).

Was es einer KI bietet

Sechs schreibgeschützte Tools, die jeweils durch einen /api/v1/*-Endpunkt unterstützt werden:

MCP-Tool

Rückgabe

list_schools

Die einzelne Schule, an die das Token gebunden ist (Array mit einem Element)

get_asset

Vollständige Asset-Details nach ID – Modell, Seriennummer, Standort, Rolle, aktuelle Ausleihe

search_assets

Bis zu 50 Assets, die mit q / item_class / category / status übereinstimmen

get_loans_for_asset

Ausleihhistorie für ein Asset (aktuell + vergangen)

list_members

Mitgliederverzeichnis – ID, Rolle, Status, external_id (keine PII)

list_asset_threads

Asset-Kommunikations-Threads mit Statusfilter (schreibgeschützt – die Ausgabe von Vendor-Tokens wird NICHT über MCP bereitgestellt)

Nur Lesezugriff. Keine update_* / create_*-Tools in v1.

Related MCP server: OfficeRnD MCP Server

Konfiguration

Zwei Umgebungsvariablen, eine davon erforderlich:

Var

Standard

Hinweise

CRESCENDER_API_TOKEN

—

Erforderlich. Zu beziehen über https://app.crescender.com.au/school/<id>/settings/integrations (die Kachel "Integrations" unter den Einstellungen Ihrer Schule). Format crsc_<random>.

CRESCENDER_API_URL

https://app.crescender.com.au

Nur überschreiben, wenn Sie auf eine Nicht-Produktionsumgebung verweisen.

CRESCENDER_MCP_LOG_LEVEL

info

Einer der Werte debug / info / warn / error. Protokolle gehen an stderr (stdout ist für das MCP-Protokoll reserviert).

CRESCENDER_MCP_HEALTH

0

In Container-Deployments auf 1 setzen, um den GET /health HTTP-Endpunkt auf PORT (Standard 3030) zu aktivieren.

CRESCENDER_API_TIMEOUT_MS

15000

Upstream-Timeout pro Anfrage.

Verbindung mit Claude Desktop (nach Veröffentlichung)

Sobald die erste Version auf npm verfügbar ist:

// ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
// %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
  "mcpServers": {
    "crescender": {
      "command": "npx",
      "args": ["-y", "@crescender/mcp-server"],
      "env": {
        "CRESCENDER_API_TOKEN": "crsc_..."
      }
    }
  }
}

Starten Sie anschließend Claude Desktop neu. Die sechs Tools sollten in der MCP-Auswahl erscheinen.

Verbindung mit Cursor (nach Veröffentlichung)

Cursor liest die MCP-Konfiguration aus .cursor/mcp.json in Ihrem Arbeitsbereich oder global aus den Einstellungen. Die Struktur entspricht dem mcpServers-Block von Claude Desktop.

Lokale Entwicklung

# Install
git clone https://github.com/lincalinca/crescender-mcp-server.git
cd crescender-mcp-server
pnpm install

# Build
pnpm build

# Smoke test (talks to stdin/stdout — Claude Desktop / Cursor will spawn it
# the same way)
CRESCENDER_API_TOKEN=crsc_... node dist/index.js

Um Ihren lokalen Klon ohne Veröffentlichung in Claude Desktop einzubinden:

{
  "mcpServers": {
    "crescender-local": {
      "command": "node",
      "args": ["/absolute/path/to/crescender-mcp-server/dist/index.js"],
      "env": {
        "CRESCENDER_API_TOKEN": "crsc_..."
      }
    }
  }
}

Container

# Build (the published image is built by .github/workflows/publish-image.yml)
docker build -t crescender-mcp-server:dev .

# Run with the in-container /health endpoint enabled
docker run --rm -i \
  -e CRESCENDER_API_TOKEN=crsc_... \
  -e CRESCENDER_MCP_HEALTH=1 \
  -p 3030:3030 \
  crescender-mcp-server:dev

Nach der Veröffentlichung wird das Image unter ghcr.io/lincalinca/crescender-mcp-server verfügbar sein.

Vertrag zur Statusslosigkeit

  • Kein In-Memory-Token-Cache: Die Validierung erfolgt bei jedem Aufruf über die Upstream-API (Widerruf erfolgt sofort).

  • Kein Dateisystem-Status: Nur stdout/stderr.

  • Die Konfiguration ist umgebungsgesteuert, wird beim Booten einmal geparst und dann eingefroren.

  • /health (sofern aktiviert) gibt { ok, api_reachable, version } zurück und prüft den Upstream /api/v1/health, um die Erreichbarkeit zu verifizieren – nicht nur "dieser Prozess lebt".

  • Graceful Shutdown: SIGTERM / SIGINT lösen ein 30-sekündiges "Drain" aus und erzwingen dann das Beenden.

Dies macht den Container k8s-bereit, ohne dass k8s-spezifischer Code erforderlich ist. Wenn die Orchestrierungsentscheidung schließlich getroffen wird (ASK / AKS / GKE / Fly / Railway / etc.), ändert sich hier nichts.

Lizenz

MIT – siehe LICENSE.

Verwandtes

  • @crescender/crescender-core – die Plattform selbst, die die /api/v1-Endpunkte bereitstellt, die dieses MCP umschließt.

  • OpenAPI-Spezifikation: https://app.crescender.com.au/api/v1/openapi.json

Available Tools

6 tools
get_assetA

Get full detail for a single asset (instrument, equipment, sub-item) by id. Includes model, serial, location, role, and the current loan if any.

Inputs: asset_id (required).

get_loans_for_assetA

Get the loan history for a single asset. Currently returns whatever loans field is embedded on the asset detail; in a future version may paginate independently.

Inputs: asset_id (required).

list_asset_threadsA

List asset-comms threads (vendor / repair / service conversations attached to assets). Read-only — vendor-token issuance is NOT exposed via this MCP.

Inputs: status, cursor.

list_membersA

List the school's members. Returns id, role, status, external_id only — no PII (email/phone are intentionally excluded from the public API).

Inputs: role, status, cursor.

list_schoolsA

List schools accessible to the calling token. Each token is bound to exactly one school, so this returns a single-item array. Useful for the AI to confirm which school it's looking at before making other calls.

Inputs: no named parameters.

search_assetsA

Search the school's assets by free-text query and/or filters. Returns up to 50 matches per page. Use the cursor field from the response to fetch the next page.

Inputs: q, item_class, category, status, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool targets a distinct resource or action: get_asset and search_assets are clearly different (detail vs. search), and loan history, threads, members, and schools are all separate concerns. No overlapping purposes.

    Naming Consistency5/5

    All tools consistently follow the 'verb_noun' pattern in lowercase snake_case (e.g., get_asset, list_asset_threads, search_assets). The naming is uniform and predictable.

    Tool Count5/5

    6 tools is well-scoped for an asset management server. Each tool covers a core area without being overwhelming or insufficient.

    Completeness2/5

    The tool surface is heavily read-only: assets have get and search but no create/update/delete; loans only show history; threads only list; members and schools only list. Missing basic write operations for the domain.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A read-only MCP server that provides access to Charles Schwab account data and market information, including portfolio positions, real-time quotes, options chains, price history, and account balances through AI assistants.
      9
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Read-only MCP server that lets a verified client connect their own AI to their trading account to read account data without order execution.
      -