Skip to main content
Glama
Crescender MCP Server

Crescender MCP Server

by lincalinca

Crescender MCP サーバー

Crescender の公開読み取り API 用の Model Context Protocol サーバーです。AI クライアント(Claude Desktop、Cursor、カスタムエージェント)を、学校の資産、貸出、メンバー、および資産通信スレッドに接続します。すべて読み取り専用で、スコープトークン認証が行われ、トークンごとに 1 つの学校に紐付けられます。

ステータス: 0.0.x — 公開前。 このパッケージはまだ npm に公開されておらず、GHCR にもプッシュされていません。公開パイプラインは存在しますが、手動トリガーに制限されています。最初のリリースは、ソースがローカルで十分にテストされた後に行われます。現時点では、クローンから実行するか、pnpm link を使用してください(以下の ローカル開発 を参照)。

AI に提供するもの

6 つの読み取り専用ツール。それぞれが /api/v1/* エンドポイントによってサポートされています。

MCP ツール

戻り値

list_schools

トークンが紐付けられている単一の学校(単一要素の配列)

get_asset

ID による資産の詳細(モデル、シリアル番号、場所、役割、現在の貸出状況)

search_assets

q / item_class / category / status に一致する最大 50 件の資産

get_loans_for_asset

1 つの資産の貸出履歴(現在および過去)

list_members

メンバーディレクトリ(ID、役割、ステータス、external_id。個人情報は含まれません)

list_asset_threads

ステータスフィルター付きの資産通信スレッド(読み取り専用。ベンダートークンの発行は MCP を介して公開されません)

読み取り専用です。v1 には update_* / create_* ツールはありません。

Related MCP server: OfficeRnD MCP Server

設定

2 つの環境変数(うち 1 つは必須):

変数

デフォルト

備考

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 に設定すると、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 を再起動してください。MCP ピッカーに 6 つのツールが表示されるはずです。

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 秒間のドレインをトリガーし、その後強制終了します。

これにより、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.
      -