Crescender MCP Server
Crescender MCP 서버
Crescender의 공개 읽기 전용 API를 위한 Model Context Protocol 서버입니다. AI 클라이언트(Claude Desktop, Cursor, 커스텀 에이전트)를 학교의 자산, 대출, 구성원 및 자산 통신 스레드에 연결합니다. 모든 기능은 읽기 전용이며, 스코프 토큰 인증을 사용하고 토큰당 하나의 학교에 바인딩됩니다.
상태: 0.0.x — 게시 전. 이 패키지는 아직 npm에 게시되거나 GHCR에 푸시되지 않았습니다. 게시 파이프라인은 존재하지만 수동 트리거로 제한되어 있습니다. 첫 번째 릴리스는 소스가 로컬에서 충분히 테스트된 후 배포될 예정입니다. 현재는 클론을 실행하거나
pnpm link를 사용하십시오(로컬 개발 참조).
AI에게 제공하는 기능
각각 /api/v1/* 엔드포인트를 지원하는 6개의 읽기 전용 도구:
MCP 도구 | 반환 값 |
| 토큰이 바인딩된 단일 학교(단일 항목 배열) |
| ID별 전체 자산 세부 정보 — 모델, 일련번호, 위치, 역할, 현재 대출 상태 |
|
|
| 단일 자산에 대한 대출 기록(현재 + 과거) |
| 구성원 디렉토리 — ID, 역할, 상태, external_id (개인정보 제외) |
| 상태 필터가 적용된 자산 통신 스레드 (읽기 전용 — 공급업체 토큰 발급은 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을 다시 시작하십시오. 6개의 도구가 MCP 선택기에 나타나야 합니다.
Cursor 연결 (게시 후)
Cursor는 작업 공간의 .cursor/mcp.json 또는 설정에서 전역적으로 MCP 구성을 읽습니다. 구조는 Claude Desktop의 mcpServers 블록과 동일합니다.
로컬 개발
# 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에서 사용할 수 있습니다.
상태 비저장 계약
메모리 내 토큰 캐시 없음: 모든 호출 시 업스트림 API를 검증합니다(즉시 취소 가능).
파일 시스템 상태 없음: stdout/stderr만 사용.
구성은 환경 변수 기반이며, 부팅 시 한 번 파싱되고 고정됩니다.
/health(활성화 시)는{ ok, api_reachable, version }을 반환하며, 단순히 "프로세스가 살아있는지" 확인하는 것이 아니라 업스트림/api/v1/health를 프로빙하여 도달 가능성을 확인합니다.정상 종료: SIGTERM / SIGINT는 30초간의 드레인(drain)을 트리거한 후 강제 종료합니다.
이것이 컨테이너를 k8s 전용 코드 없이 k8s 준비 상태로 만드는 이유입니다. 오케스트레이션 결정(ASK / AKS / GKE / Fly / Railway 등)이 나중에 내려지더라도 여기서는 아무것도 변경되지 않습니다.
라이선스
MIT — LICENSE를 참조하십시오.
관련 항목
@crescender/crescender-core— 이 MCP가 래핑하는/api/v1엔드포인트를 제공하는 플랫폼 자체입니다.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.-