LexQ — the Decision Operations Platform for engineering teams

LexQ CLI

面向工程团队的决策运营平台。 LexQ 的 CLI 和 MCP 服务。将业务规则移出部署流水线，通过影响模拟验证每次变更，并且无需 推送 Git 即可发布。

网站 · 文档 · 控制台 · MCP Registry

---

为什么选择 LexQ？

定价、促销、费用逻辑和资格检查等业务规则经常变化。但每次变更都要像核心应用代码一样经历 PR → 审查 → 暂存 → 部署的流程，因此即使是小改动，也得等到下次发布。

LexQ 将这些规则从代码中分离出来。 您的服务调用 LexQ API 来评估规则。您可以在可视化控制台中或通过此 CLI 修改规则，使用影响模拟对照以往执行记录或您上传的数据集来测试每项变更，并且无需发布应用即可部署规则。

每项决策都会留下完整的审计记录。

安装

npm install -g @lexq/cli

或者无需安装即可运行：

npx @lexq/cli

需要 Node.js 22+。

快速入门

# 1. Authenticate
lexq auth login
# Enter your API key (create one with the Manage scope at console.lexq.io → Management → API Keys)

# 2. Verify
lexq auth whoami

# 3. Start from a domain template — provisions facts, sample rules, and a policy group
lexq domain-templates list
lexq domain-templates apply --template ECOMMERCE
# Returns: policyGroupId, policyVersionId, factsCreated, rulesCreated

# 4. Test a rule against your data before shipping
lexq analytics dry-run --version-id <VERSION_ID> --debug \
  --json '{"facts":{"loyaltyTier":"PLATINUM","purchaseSubtotalUsd":150}}'

# 5. Deploy
lexq deploy publish --group-id <GROUP_ID> --version-id <VERSION_ID> --memo "v1"
lexq deploy live --group-id <GROUP_ID> --version-id <VERSION_ID> --memo "Initial deploy"

面向 AI Agent

Claude、Cursor 和其他兼容 MCP 的 Agent 可以使用模型上下文协议来管理策略组、版本、规则和事实，运行模拟和重放，部署版本，并读取执行历史记录。

审批在您的 MCP 客户端中进行，由客户端决定哪些工具调用需要您确认。部署、回滚和取消部署工具被标记为破坏性操作，因此客户端可以在运行前征求您的同意。

Claude.ai（云端，无需安装）

1. 自定义 → 连接器 → + 添加 → 添加自定义连接器
2. 为其命名，输入 https://mcp.lexq.io，然后选择 立即登录
3. 在打开的 LexQ 页面中登录并为 MCP 生成新的 API 密钥，或选择 我已有 API 密钥 并粘贴现有密钥
4. 这些工具现已可在每次对话中使用

远程（Streamable HTTP）

适用于任何支持远程服务的 MCP 客户端：

{
  "mcpServers": {
    "lexq": {
      "url": "https://mcp.lexq.io"
    }
  }
}

OAuth 2.1 身份验证由您的客户端自动处理。

本地（stdio）

将 LexQ CLI 作为本地 MCP 服务运行：

lexq serve --mcp

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "lexq": {
      "command": "npx",
      "args": [
        "-y",
        "@lexq/cli",
        "serve",
        "--mcp"
      ]
    }
  }
}

VS Code / Cursor

.vscode/mcp.json：

{
  "servers": {
    "lexq": {
      "command": "npx",
      "args": [
        "-y",
        "@lexq/cli",
        "serve",
        "--mcp"
      ]
    }
  }
}

前提条件： 必须先运行一次 lexq auth login，将 API 密钥保存到 ~/.lexq/config.json，或者在客户端的环境变量配置块中设置 LEXQ_API_KEY。

Registry

该服务已列入官方 MCP Registry，名称为 io.lexq/lexq。浏览 Registry 的客户端可以在同一条目中找到 npm 包和托管端点。

协议支持

本地 stdio 服务和托管的 Streamable HTTP 端点都通过同一套工具定义提供两个 MCP 版本，因此客户端无论采用哪种方式，都能看到相同的工具。

版本	客户端的连接方式
2026-07-28	每个请求都带有 _meta 封装。无需握手。
2025-11-25	使用 initialize 握手。

无需进行任何配置。服务会根据初始消息所用的版本进行响应，因此客户端可以按自己的计划迁移到 2026-07-28，尚未迁移的客户端也能继续正常工作。

AI Agent 技能

LexQ CLI 附带 AI Agent 技能：结构化文档，用于告知 Agent 如何使用每种工具。

skills/
├── lexq-shared/SKILL.md       Core concepts, auth, workflow
├── lexq-groups/SKILL.md       Policy groups, conflict resolution, A/B testing
├── lexq-rules/SKILL.md        Condition syntax, action types, mutex
├── lexq-simulation/SKILL.md   Dry run, Impact Simulation, compare
├── lexq-execution/SKILL.md    History, stats, failure logs, provenance, replay, latency profile
└── lexq-recipes/SKILL.md      End-to-end recipes

.claude/CLAUDE.md              Claude Code project context
AGENTS.md                      Universal agent guide (Cursor, Windsurf, Gemini CLI, Cline)
CONTEXT.md                     Platform architecture & glossary

安装 @lexq/cli 后，Agent 可以从以下位置读取技能：

node_modules/@lexq/cli/skills/
node_modules/@lexq/cli/AGENTS.md
node_modules/@lexq/cli/CONTEXT.md

命令

lexq auth                  login | logout | whoami
lexq status                API health check
lexq serve                 Run as MCP stdio server (--mcp)
lexq groups                list | get | create | update | delete | reorder
lexq groups ab-test        start | stop | adjust
lexq versions              list | get | create | update | delete | clone
lexq rules                 list | get | create | update | delete | reorder | toggle
lexq facts                 list | create | update | delete | action-metadata | unregistered
lexq domain-templates      list | preview | apply
lexq deploy                publish | live | rollback | undeploy | history | detail | overview | deployable | diff | schedule | unschedule | schedules
lexq analytics             dry-run | dry-run-compare | requirements
lexq analytics simulation  start | status | list | cancel | export
lexq analytics dataset     upload | template
lexq profile               <groupId> — per-rule latency profile
lexq history               list | get | stats
lexq replay                decision | start | list | get | cancel
lexq logs                  list | get | action | bulk-action
lexq provenance            get | reveal-audits
lexq webhook-subscriptions list | get | save | delete | test

全局选项

标志	描述
--format <json|table>	输出格式（默认：json）
--api-key <key>	覆盖已存储的 API 密钥
--base-url <url>	覆盖 API 基础 URL
--dry-run	预览 HTTP 请求，但不执行
--verbose	显示请求／响应详情
--no-color	禁用彩色输出

配置

配置存储在 ~/.lexq/config.json：

{
  "apiKey": "YOUR_API_KEY",
  "baseUrl": "https://api.lexq.io/api/v1/partners",
  "format": "json"
}

该文件以纯文本形式保存 API 密钥。文件权限为 0600，并存放在权限为 0700 的目录中，因此只有所有者可以读取。如果旧版本创建文件时使用了较宽松的权限，CLI 会在下次保存文件时收紧权限。

环境变量

MCP 服务（lexq serve --mcp）会读取这些变量，它们的优先级高于已存储的配置。编辑器或 CI 可以通过客户端自身的配置块指定目标环境，而无需写入 ~/.lexq/config.json。CLI 命令则使用 --api-key 和 --base-url。

变量	覆盖项
LEXQ_API_KEY	apiKey
PARTNER_BASE_URL	baseUrl

开发

git clone https://github.com/lexq-io/lexq-cli.git
cd lexq-cli
pnpm install
pnpm build
pnpm start -- groups list

pnpm typecheck                  # Type check
pnpm lint                       # ESLint
pnpm build                      # Bundle to dist/

这些检查会验证陈述的事实是否与其所属对象一致。它们全部在 CI 中运行。

pnpm enums:check                # Generated enums match the engine contract
pnpm prose:check                # Numbers and code tables in prose match the contract
pnpm ab-key:check               # Tool descriptions still name the A/B traffic key
pnpm surface:check              # Nothing internal reached a public file
pnpm registry:check             # server.json agrees with package.json and src/mcp/server-info.json
pnpm schemas:check              # tools/list matches the recorded snapshot (needs a build)
pnpm test:fact-key              # Fact key grammar
pnpm test:decimals              # Metric precision display
pnpm test:export-format         # Export byte fidelity
pnpm protocol:check             # README matches the revisions the server serves

安全

如需报告漏洞，请通过 GitHub 私密报告表单提交。 相关政策（包括范围说明）见 SECURITY.md。

许可证

Apache-2.0