WestCoast Charts

West Coast Charts エージェントツール

west-coast-charts-agent 0.2.4 は、wcc CLI、wcc-mcp stdio／HTTP サーバー、ヘッドレスレンダリング API を提供します。このバージョンは、West Coast Charts 1.1.5 以降の 1.1.x リリースと、対応するバリデーター、スキーマ、describe モジュールと組み合わせて使用してください。

インストール

Node.js 20 以降が必要です。リリースのインストールコマンドは次のとおりです。

npm install 'west-coast-charts@>=1.1.5 <1.2.0' [email protected]
npx --no-install wcc --help
npx --no-install wcc version --json
npx --no-install wcc-mcp --help
npx --no-install wcc-mcp --version

このコマンドは、エージェントツール 0.2.4 と互換性のある West Coast Charts 1.1.x のバージョンを選択します。0.2.4 以降、エージェントパッケージは west-coast-charts >=1.1.5 <1.2.0 を通常の依存関係として宣言しています（以前はオプションのピア依存関係でした）。そのため、npm と npx は互換性のある Core を自動的にインストールします。すでに互換性のある Core がインストールされている場合（同じ名前で別途提供された完全版パッケージを含む）、それが再利用されます。リリースの提供状況とアーティファクトのチェックサムはリリースメタデータに記録されています。このインストールガイドは、その検証に代わるものではありません。バージョン 0.2.1 は、変更されない公開済みのインストール修正リリースとして維持されています。公開されている Core パッケージとエージェントパッケージには、Premium の実装もライセンス発行元も含まれていません。公開済みの npm インストールに、プライベートなワークスペースパッケージやアクセストークンは必要ありません。このパッケージには公式 MCP Registry 用の mcpName io.github.Lokumbus/west-coast-charts-agent が含まれています。レジストリへの掲載は別の手順であり、ここでは掲載済みであることを示していません。

npx で MCP サーバーを実行する

npx -y west-coast-charts-agent

を実行すると、stdio MCP サーバーが起動します（west-coast-charts-agent バイナリは wcc-mcp のエイリアスです）。0.2.4 以降、無償の west-coast-charts Core（>=1.1.5 <1.2.0）は通常の依存関係のため、npx が自動的にインストールします。Premium ランタイムを使用するには、別途提供された完全版ライブラリを WCC_LIB_ROOT に指定してください。MCP クライアントの設定：

{ "mcpServers": { "west-coast-charts": { "command": "npx", "args": ["-y", "west-coast-charts-agent"] } } }

レンダリングと検証

npx --no-install wcc examples get line-basic
npx --no-install wcc chart validate example:line-basic
npx --no-install wcc chart render example:line-basic > chart.svg
npx --no-install wcc chart render example:line-basic --format png > chart.png
npx --no-install wcc chart table example:line-basic
npx --no-install wcc options schema chart.orient

仕様は実行可能な JavaScript ではなく、通常の JSON です。検証には実際に対応する dist/agent/validate.common.js を使用し、すべての検証テーブルは実際のチャートの describe() から取得します。モジュールの欠落やレンダリングの失敗はエラーとなり、プレースホルダーの出力が成功として扱われることはありません。wcc schema は、すべてのコマンドとその終了ステータスを説明します。

MCP

インストール済みの実行ファイルの絶対パスを指定して、ローカルの MCP クライアントを設定してください。

{"mcpServers":{"west-coast-charts":{"command":"/absolute/project/node_modules/.bin/wcc-mcp","args":[]}}}

サーバーはデフォルトで stdio を使用します。プロトコル出力は stdout に、ログは stderr に出力されます。7 つのツールで、レンダリング、検証、説明、スキーマ、型、例、例の取得を行えます。SDK 1.32.2 は MCP 2025-11-25 と、ネゴシエーションされたそれ以前のリビジョンをサポートします。これは MCP 2026-07-28 への準拠を主張するものではありません。MCP の設定を参照してください。--help と --version はサーバーを起動せずに終了します。

Premium と Orient

無償の Core には、無償のチャートタイプと Orient 機能が含まれます。エージェントのアーカイブには、Premium の実装は含まれていません。Premium をレンダリングするには、対応する West Coast Charts 1.1.x の完全版ディストリビューションを別途入手してください。インストール済みの完全版 west-coast-charts パッケージは通常どおり解決されます。別途展開したものを選択する場合に限り、WCC_LIB_ROOT を使用してください。WCC_LICENSE_KEY を非公開で設定するか、CLI の --license-key-file を使用してください。キーだけでは Premium コードはインストールされません。独立したライセンスで提供されているソースについて、既存の MIT ライセンスの権利に変更はありません。

quintTimeline、quintConvergence、vitalsClock、schedule など、13 種類の Premium タイプが認識されます。実際のタイプモジュールが存在している必要があります。キーがない場合、ライセンスエラーが発生します。--evaluation を明示すると、Premium ランタイムがインストールされている場合に、ウォーターマーク付きで評価できます。無効、期限切れ、またはその他の理由で拒否されたキーは引き続き拒否されます。評価モードはキーの回避手段ではありません。キーは SVG、テーブル、ログ、パッケージには書き込まれません。

ソースとテスト

ソースワークスペースには、非公開のワークスペースパッケージが3つあります。完全なソースチェックアウトで npm ci を実行すると、ロックされた開発依存関係がインストールされ、npm test を実行するとワークスペースのテストが実行されます。WCC_LIB_ROOT を通じて完全なテストランタイムを選択してください。Premium の受け入れテストには、この別個のランタイムが必要です。オプションの署名受け入れテストでは、キーを表示せずに保護されたフィクスチャパスを読み取ります。Core のみのテスト実行に成功しても、Premium のサポートが証明されるわけではありません。

リリースのパッケージ化はメンテナーが行う作業であり、インストール済みパッケージのコマンドではありません。内部パイプラインでは、レビュー済みの正確な Git コミットを分離されたステージングディレクトリにエクスポートし、明示されたソース／フォント／ライセンスの許可リストをコピーして、内部インポートを解決し、ロックファイルから公開依存関係を固定し、ファイルハッシュを記録する必要があります。リリースをパッケージ化する前に、テスト済みの Core と完全なランタイムの成果物を、正確なバージョン、コミット、SHA256 によって紐付ける必要があります。新規利用者は、生成されたアーカイブをワークスペース外にインストールし、祖先ディレクトリの依存関係へのフォールバックなしで、CLI／MCP のインポート、レンダリング、ライセンス関連のエラーを確認する必要があります。インストール済みパッケージには、ビルドスクリプトやテストは含まれません。旧式のソース専用 scripts/build-distribution.cjs と分離インストールのレシピには、RC7 のフィクスチャ固定値が含まれています。これらは 1.1.1 のリリースパイプラインではなく、現在の来歴を主張するために使用してはなりません。

ツール類：MIT。フォントの著作権、SIL OFL のテキストおよび改変については、フォントの来歴を参照してください。チャートライブラリのライセンスと帰属表示は、別個のライブラリ配布物に引き続き記載されます。NOTICEを参照してください。

0.2.1 インストールの修正

バージョン 0.2.0 では内部 CLI インポートが1つ欠落しており、開発ワークスペース外では --help を指定した場合でも MODULE_NOT_FOUND が発生することがあります。この不具合は、変更不可の 0.2.1 で修正されました。そのパッケージ化チェックでは、裸のワークスペースインポートを拒否します。また、インストールの受け入れテストは、HOME を空にしたオペレーティングシステムの一時ディレクトリで、モジュール解決ガードを使用して実行されます。以前のリポジトリ内でのインストール検証は、祖先のワークスペース依存関係の影響を受けており、分離インストールの結果ではありません。0.2.0 のタグとアーカイブは変更されていません。

0.2.2 HTTP 認可の修正

バージョン 0.2.2 では、フェイルクローズの JWKS 設定が追加されました。issuer、audience、必須スコープはすべて明示的に指定する必要があります。また、トークンは署名、issuer、audience、有効期限、スコープの各チェックを満たす必要があります。キャッシュされたレンダリングリソースは、issuer、subject、クライアント ID ごとに分離されます。この修正には 0.2.2 が必要です。0.2.1 は書き換えられたり、暗黙的にアップグレードされたりしません。ローカルの stdio 利用では、既存のファイルシステム権限の境界が維持されます。環境変数の正確な契約とサポート対象のプロトコルについては、HTTP のデプロイと認可を参照してください。

表記について

ApexCharts、react-apexcharts、vue3-apexcharts、ng-apexcharts は Apex Software, Inc. の商標であり、同社は Infragistics, Inc. の子会社であると表明しています。WestCoast Charts は WestCoast Software (Inh. Peter Kannengießer) の独立した製品であり、Apex Software, Inc. または Infragistics, Inc. とは提携、後援、推奨の関係にありません。WestCoast Charts の一部は、MIT License（Copyright (c) 2018 ApexCharts）の下で公開された ApexCharts 4.7.0 を基にしています。「ApexCharts-compatible」とは、WestCoast Charts が ApexCharts 4.7.0 の設定オプションを概ねサポートすることを意味します。相違点は移行ガイドに記載されています。