Skip to main content
Glama
Crescender MCP Server

Crescender MCP Server

by lincalinca

Crescender MCP 서버

Crescender의 공개 읽기 전용 API를 위한 Model Context Protocol 서버입니다. AI 클라이언트(Claude Desktop, Cursor, 커스텀 에이전트)를 학교의 자산, 대출, 구성원 및 자산 통신 스레드에 연결합니다. 모든 기능은 읽기 전용이며, 스코프 토큰 인증을 사용하고 토큰당 하나의 학교에 바인딩됩니다.

상태: 0.0.x — 게시 전. 이 패키지는 아직 npm에 게시되거나 GHCR에 푸시되지 않았습니다. 게시 파이프라인은 존재하지만 수동 트리거로 제한되어 있습니다. 첫 번째 릴리스는 소스가 로컬에서 충분히 테스트된 후 배포될 예정입니다. 현재는 클론을 실행하거나 pnpm link를 사용하십시오(로컬 개발 참조).

AI에게 제공하는 기능

각각 /api/v1/* 엔드포인트를 지원하는 6개의 읽기 전용 도구:

MCP 도구

반환 값

list_schools

토큰이 바인딩된 단일 학교(단일 항목 배열)

get_asset

ID별 전체 자산 세부 정보 — 모델, 일련번호, 위치, 역할, 현재 대출 상태

search_assets

q / item_class / category / status와 일치하는 최대 50개의 자산

get_loans_for_asset

단일 자산에 대한 대출 기록(현재 + 과거)

list_members

구성원 디렉토리 — ID, 역할, 상태, external_id (개인정보 제외)

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 (학교 설정의 "통합" 타일)에서 발급받으세요. 형식은 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로 설정하여 PORT(기본값 3030)에서 GET /health HTTP 엔드포인트를 활성화합니다.

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을 다시 시작하십시오. 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 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.
      -