WestCoast Charts

West Coast Charts Agent 工具

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

此命令会选择 Agent 工具 0.2.4 和兼容的 West Coast Charts 1.1.x 版本。从 0.2.4 起，Agent 包将 west-coast-charts >=1.1.5 <1.2.0 声明为常规依赖（此前为可选 peer 依赖），因此 npm 和 npx 会自动安装匹配的 Core；如果已安装兼容的 Core（包括单独提供的同名完整包），则会复用该版本。发布可用性和制品校验和记录在发布元数据中；本安装指南不替代该验证。版本 0.2.1 仍是不可变的、已发布的安装修复版本。公开的 Core 包和 Agent 包均不包含 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

规格文件是纯 JSON，不是可执行的 JavaScript。验证使用实际匹配的 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。七个工具涵盖渲染、验证、描述、架构、类型、示例和示例获取。SDK 1.32.2 支持 MCP 2025-11-25 及其协商使用的较早修订版；这并不代表符合 MCP 2026-07-28。请参阅 MCP 配置。--help 和 --version 会退出，不会启动服务。

Premium 和 Orient

免费 Core 包含免费的图表类型和 Orient 功能。Agent 归档文件不包含 Premium 实现。要渲染 Premium，请另行获取匹配的完整 West Coast Charts 1.1.x 发行包。已安装的完整 west-coast-charts 包会正常解析；仅在选择单独解压的版本时使用 WCC_LIB_ROOT。请私密设置 WCC_LICENSE_KEY，或使用 CLI --license-key-file。仅有密钥并不会安装 Premium 代码。独立许可的源代码中现有的 MIT 权利保持不变。

可识别 13 种 Premium 类型，包括 quintTimeline、quintConvergence、vitalsClock 和 schedule。必须存在其实际类型模块。缺少密钥会产生许可证错误。安装了 Premium 运行时时，显式指定 --evaluation 可启用带水印的评估。无效、过期或以其他方式被拒绝的密钥仍会被拒绝；评估模式不能绕过密钥检查。密钥不会写入 SVG、表格、日志或包中。

源代码与测试

源代码工作区包含三个私有工作区包。在完整的源代码检出中，npm ci 会安装锁定的开发依赖项，npm test 会运行工作区测试。通过 WCC_LIB_ROOT 选择完整的测试运行时；Premium 验收需要单独的运行时。可选的签名验收会读取受保护的测试样例路径，但不会打印密钥。Core 单独测试成功并不能证明支持 Premium。

发布打包是维护者的操作，不是已安装包的命令。内部流水线必须将经过精确审查的 Git 提交导出到隔离的暂存目录，复制明确列出的源代码／字体／许可证白名单，解析内部导入，从锁文件中固定公共依赖项，并记录文件哈希值。打包发布版本前，必须通过精确的版本、提交和 SHA256 绑定经过测试的 Core 与完整运行时制品。全新的使用者必须在工作区之外安装生成的归档，并验证 CLI／MCP 导入、渲染和许可证错误，且不得回退到祖先目录中的依赖项。已安装的包不包含构建脚本或测试。较早的仅源代码 scripts/build-distribution.cjs 和隔离安装方案包含 RC7 测试样例固定项；它们不是 1.1.1 发布流水线，不得用于声称当前来源可追溯。

工具：MIT。字体版权、SIL OFL 文本及修改内容：字体来源。图表库许可证和署名信息仍保留在单独的库分发包中。请参阅 NOTICE。

0.2.1 安装修正

版本 0.2.0 漏掉了一项内部 CLI 导入，在开发工作区之外可能会出现 MODULE_NOT_FOUND，即使运行 --help 也如此。此缺陷已在不可变版本 0.2.1 中修正。其打包检查会拒绝裸工作区导入，安装验收则在操作系统临时目录中运行，并使用空的 HOME 和模块解析保护机制。较早的仓库内安装证明受到祖先工作区依赖项污染，并非隔离安装结果。0.2.0 标签和归档保持不变。

0.2.2 HTTP 授权修正

版本 0.2.2 增加了默认拒绝的 JWKS 配置：必须显式提供签发者、受众和必需作用域；令牌必须通过签名、签发者、受众、有效期和作用域检查。缓存的渲染资源按签发者、主体和客户端身份隔离。此修正需要使用 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 发布的 ApexCharts 4.7.0（Copyright (c) 2018 ApexCharts）。“兼容 ApexCharts”表示 WestCoast Charts 大体支持 ApexCharts 4.7.0 的配置选项；差异已列于迁移指南。