Skip to main content
Glama
Crescender MCP Server

Crescender MCP Server

by lincalinca

Crescender MCP Server

Сервер Model Context Protocol для публичного API Crescender только для чтения. Подключает ИИ-клиентов (Claude Desktop, Cursor, пользовательских агентов) к активам школы, займам, участникам и веткам коммуникаций по активам — всё это доступно только для чтения, аутентифицируется через scope-токен и привязано к одной школе на токен.

Статус: 0.0.x — до публикации. Этот пакет еще не был опубликован в npm или отправлен в GHCR. Пайплайны публикации существуют, но требуют ручного запуска; первый релиз будет выпущен после того, как исходный код пройдет проверку в локальной среде. На данный момент запускайте из клона или используйте pnpm link (см. Локальная разработка ниже).

Что это дает ИИ

Шесть инструментов только для чтения, каждый из которых работает через эндпоинт /api/v1/*:

MCP-инструмент

Возвращает

list_schools

Единственную школу, к которой привязан токен (массив из одного элемента)

get_asset

Полные данные об активе по id — модель, серийный номер, местоположение, роль, текущий заем

search_assets

До 50 активов, соответствующих q / item_class / category / status

get_loans_for_asset

Историю займов для одного актива (текущие + прошлые)

list_members

Справочник участников — id, роль, статус, external_id (без PII)

list_asset_threads

Ветки коммуникаций по активам с фильтром по статусу (только чтение — выдача токенов поставщика НЕ предоставляется через MCP)

Только чтение. В v1 нет инструментов update_* / create_*.

Related MCP server: OfficeRnD MCP Server

Конфигурация

Две переменные окружения, одна из которых обязательна:

Переменная

По умолчанию

Примечания

CRESCENDER_API_TOKEN

—

Обязательно. Получите на странице https://app.crescender.com.au/school/<id>/settings/integrations (плитка "Integrations" в настройках вашей школы). Формат crsc_<random>.

CRESCENDER_API_URL

https://app.crescender.com.au

Переопределяйте только если вы указываете на непроизводственное развертывание.

CRESCENDER_MCP_LOG_LEVEL

info

Одно из значений: debug / info / warn / error. Логи направляются в stderr (stdout зарезервирован для протокола MCP).

CRESCENDER_MCP_HEALTH

0

Установите 1 в контейнерных развертываниях, чтобы включить HTTP-эндпоинт GET /health на порту PORT (по умолчанию 3030).

CRESCENDER_API_TIMEOUT_MS

15000

Таймаут вышестоящего запроса для каждого вызова.

Подключение Claude Desktop (после публикации)

Как только первая версия появится в 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_..."
      }
    }
  }
}

Затем перезапустите Claude Desktop. Шесть инструментов должны появиться в меню выбора MCP.

Подключение Cursor (после публикации)

Cursor считывает конфигурацию MCP из файла .cursor/mcp.json в вашем рабочем пространстве или глобально из настроек. Структура такая же, как у блока mcpServers в Claude Desktop.

Локальная разработка

# 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

Чтобы подключить ваш локальный клон к Claude Desktop без публикации:

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

Контейнер

# 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

После публикации образ будет доступен по адресу ghcr.io/lincalinca/crescender-mcp-server.

Контракт stateless-архитектуры

  • Нет кэширования токенов в памяти: проверка выполняется через вышестоящий API при каждом вызове (отзыв происходит мгновенно).

  • Нет состояния файловой системы: только stdout/stderr.

  • Конфигурация управляется переменными окружения, парсится один раз при загрузке и замораживается.

  • /health (если включено) возвращает { ok, api_reachable, version } и проверяет вышестоящий /api/v1/health для подтверждения доступности — а не просто "процесс запущен".

  • Корректное завершение работы: SIGTERM / SIGINT запускают 30-секундный период завершения, затем принудительный выход.

Это делает контейнер готовым к k8s без какого-либо специфичного для k8s кода. Когда решение об оркестрации будет принято (ASK / AKS / GKE / Fly / Railway и т.д.), здесь ничего не изменится.

Лицензия

MIT — см. LICENSE.

Связанные проекты

  • @crescender/crescender-core — сама платформа, которая обслуживает эндпоинты /api/v1, обернутые этим MCP.

  • Спецификация 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.
      -