Crescender MCP Server
Crescender MCP Server
Сервер Model Context Protocol для публичного API Crescender только для чтения. Подключает ИИ-клиентов (Claude Desktop, Cursor, пользовательских агентов) к активам школы, займам, участникам и веткам коммуникаций по активам — всё это доступно только для чтения, аутентифицируется через scope-токен и привязано к одной школе на токен.
Статус: 0.0.x — до публикации. Этот пакет еще не был опубликован в npm или отправлен в GHCR. Пайплайны публикации существуют, но требуют ручного запуска; первый релиз будет выпущен после того, как исходный код пройдет проверку в локальной среде. На данный момент запускайте из клона или используйте
pnpm link(см. Локальная разработка ниже).
Что это дает ИИ
Шесть инструментов только для чтения, каждый из которых работает через эндпоинт /api/v1/*:
MCP-инструмент | Возвращает |
| Единственную школу, к которой привязан токен (массив из одного элемента) |
| Полные данные об активе по id — модель, серийный номер, местоположение, роль, текущий заем |
| До 50 активов, соответствующих |
| Историю займов для одного актива (текущие + прошлые) |
| Справочник участников — id, роль, статус, external_id (без PII) |
| Ветки коммуникаций по активам с фильтром по статусу (только чтение — выдача токенов поставщика НЕ предоставляется через MCP) |
Только чтение. В v1 нет инструментов update_* / create_*.
Related MCP server: OfficeRnD MCP Server
Конфигурация
Две переменные окружения, одна из которых обязательна:
Переменная | По умолчанию | Примечания |
| — | Обязательно. Получите на странице |
|
| Переопределяйте только если вы указываете на непроизводственное развертывание. |
|
| Одно из значений: |
|
| Установите |
|
| Таймаут вышестоящего запроса для каждого вызова. |
Подключение 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 toolsget_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
Scored across 6 tools
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.
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.
6 tools is well-scoped for an asset management server. Each tool covers a core area without being overwhelming or insufficient.
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
Related MCP Connectors
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
Read-only MCP server exposing a user ORANO library to their own AI agent.
Read-only MCP server for The Quiet Protocol's engines, benchmarks, proof, and business data.
Read-only MCP server for the OPERANT AI operating-agent calibration benchmark.
Related MCP Servers
- AlicenseAqualityDmaintenanceA 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.9MIT
- AlicenseAqualityDmaintenanceA read-only MCP server that connects AI assistants to the OfficeRnD coworking and flex-space management platform. It enables natural language queries for community members, space bookings, billing records, and office resources.51MIT
- AlicenseAqualityDmaintenanceRead-only MCP server for Litmos LMS that exposes user profiles, course results, and training completion data to AI clients.8MIT

milele-prime-mcpofficial
FlicenseNot gradedqualityDmaintenanceRead-only MCP server that lets a verified client connect their own AI to their trading account to read account data without order execution.-