Skip to main content
Glama
Crescender MCP Server

Crescender MCP Server

by lincalinca

Servidor MCP de Crescender

Servidor del Protocolo de Contexto de Modelo (MCP) para la API pública de solo lectura de Crescender. Conecta clientes de IA (Claude Desktop, Cursor, agentes personalizados) con los activos, préstamos, miembros e hilos de comunicaciones de activos de una escuela; todo en modo de solo lectura, autenticado mediante token de alcance y vinculado a una única escuela por token.

Estado: 0.0.x — pre-publicación. Este paquete aún no se ha publicado en npm ni se ha enviado a GHCR. Las canalizaciones de publicación existen pero están restringidas a activadores manuales; la primera versión se lanzará cuando el código fuente haya sido probado bajo presión localmente. Por ahora, ejecútelo desde un clon o un pnpm link (consulte Desarrollo local a continuación).

Qué ofrece a una IA

Seis herramientas de solo lectura, cada una respaldada por un endpoint /api/v1/*:

Herramienta MCP

Devuelve

list_schools

La única escuela a la que está vinculado el token (matriz de un solo elemento)

get_asset

Detalle completo del activo por id: modelo, serie, ubicación, rol, préstamo actual

search_assets

Hasta 50 activos que coincidan con q / item_class / category / status

get_loans_for_asset

Historial de préstamos de un activo (actual + pasado)

list_members

Directorio de miembros: id, rol, estado, external_id (sin PII)

list_asset_threads

Hilos de comunicaciones de activos con filtro de estado (solo lectura: la emisión de tokens de proveedor NO se expone a través de MCP)

Solo lectura. No hay herramientas update_* / create_* en la v1.

Related MCP server: OfficeRnD MCP Server

Configuración

Dos variables de entorno, una de ellas obligatoria:

Var

Predeterminado

Notas

CRESCENDER_API_TOKEN

—

Obligatorio. Emítalo desde https://app.crescender.com.au/school/<id>/settings/integrations (el mosaico "Integrations" en la configuración de su escuela). Formato crsc_<random>.

CRESCENDER_API_URL

https://app.crescender.com.au

Solo sobrescriba si apunta a una implementación que no sea de producción.

CRESCENDER_MCP_LOG_LEVEL

info

Uno de debug / info / warn / error. Los registros van a stderr (stdout está reservado para el protocolo MCP).

CRESCENDER_MCP_HEALTH

0

Establézcalo en 1 en implementaciones de contenedor para habilitar el endpoint HTTP GET /health en PORT (predeterminado 3030).

CRESCENDER_API_TIMEOUT_MS

15000

Tiempo de espera ascendente por solicitud.

Conexión con Claude Desktop (una vez publicado)

Una vez que la primera versión esté en npm:

// ~/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_..."
      }
    }
  }
}

Luego reinicie Claude Desktop. Las seis herramientas deberían aparecer en el selector de MCP.

Conexión con Cursor (una vez publicado)

Cursor lee la configuración de MCP desde .cursor/mcp.json en su espacio de trabajo, o globalmente desde la configuración. La forma es la misma que el bloque mcpServers de Claude Desktop.

Desarrollo local

# 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

Para conectar su clon local a Claude Desktop sin publicar:

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

Contenedor

# 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

Una vez publicado, la imagen estará disponible en ghcr.io/lincalinca/crescender-mcp-server.

Contrato de apátrida (Statelessness)

  • Sin caché de tokens en memoria: la validación llega a la API ascendente en cada llamada (la revocación es inmediata).

  • Sin estado en el sistema de archivos: solo stdout/stderr.

  • La configuración está basada en variables de entorno, se analiza una vez al inicio y se congela.

  • /health (cuando está habilitado) devuelve { ok, api_reachable, version } y sondea el /api/v1/health ascendente para verificar la accesibilidad, no solo "este proceso está vivo".

  • Apagado elegante: SIGTERM / SIGINT activan un drenaje de 30 segundos y luego fuerzan la salida.

Esto es lo que hace que el contenedor esté listo para k8s sin ningún código específico de k8s. Cuando finalmente se tome la decisión de orquestación (ASK / AKS / GKE / Fly / Railway / etc.), nada cambia aquí.

Licencia

MIT: consulte LICENSE.

Relacionado

  • @crescender/crescender-core: la plataforma en sí, que sirve los endpoints /api/v1 que envuelve este MCP.

  • Especificación OpenAPI: 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.
      -