Crescender MCP Server
Crescender MCP サーバー
Crescender の公開読み取り API 用の Model Context Protocol サーバーです。AI クライアント(Claude Desktop、Cursor、カスタムエージェント)を、学校の資産、貸出、メンバー、および資産通信スレッドに接続します。すべて読み取り専用で、スコープトークン認証が行われ、トークンごとに 1 つの学校に紐付けられます。
ステータス: 0.0.x — 公開前。 このパッケージはまだ npm に公開されておらず、GHCR にもプッシュされていません。公開パイプラインは存在しますが、手動トリガーに制限されています。最初のリリースは、ソースがローカルで十分にテストされた後に行われます。現時点では、クローンから実行するか、
pnpm linkを使用してください(以下の ローカル開発 を参照)。
AI に提供するもの
6 つの読み取り専用ツール。それぞれが /api/v1/* エンドポイントによってサポートされています。
MCP ツール | 戻り値 |
| トークンが紐付けられている単一の学校(単一要素の配列) |
| ID による資産の詳細(モデル、シリアル番号、場所、役割、現在の貸出状況) |
|
|
| 1 つの資産の貸出履歴(現在および過去) |
| メンバーディレクトリ(ID、役割、ステータス、external_id。個人情報は含まれません) |
| ステータスフィルター付きの資産通信スレッド(読み取り専用。ベンダートークンの発行は MCP を介して公開されません) |
読み取り専用です。v1 には update_* / create_* ツールはありません。
Related MCP server: OfficeRnD MCP Server
設定
2 つの環境変数(うち 1 つは必須):
変数 | デフォルト | 備考 |
| — | 必須。 |
|
| 本番環境以外のデプロイメントを指す場合にのみ上書きしてください。 |
|
|
|
|
| コンテナデプロイメントで |
|
| リクエストごとのアップストリームタイムアウト。 |
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 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.-