dxpert.ai — industrial AI-readiness & UNS agents

@dxpert/mcp

Claude Code、Codex、または任意の MCP クライアントなどのローカルランタイムから dxp_ API キーを使用するための、stdio MCP サーバーです。

キーもサーバーもそれぞれ1つです。キーで利用できる機能は、アカウントのプランによって決まります。

• 無料アカウント（カード不要）：月10回までの質問が可能な dxpert Advisor、Spreadsheet-to-agent コンバーター、スターターキット、診断ツール、Try Pro — dxpert Pro に含まれる任意のエージェントで、合計5回実行できます。
• dxpert Pro：すべての UNS エージェント（OEE Narrator、Maintenance Copilot、Root-Cause Analyst、Alarm Triage、Shift Reporter）と、今後追加されるすべてのエージェント、月間回数の制限がない dxpert Advisor、および独自のエージェント向けのルーター／API アクセスを、1つの月間利用枠内で利用できます。Namespace Architect は近日公開予定で、リリース後は dxpert Pro に含まれます。

プランと最新の価格については、GET {api_base}/api/catalog または dxpert.ai/store をご覧ください。dxpert.ai/store/account で無料キーを作成できます。

このサーバーにランタイム依存関係はありません。MCP stdio JSON-RPC ハンドシェイク（initialize、tools/list、tools/call）を独自に実装し、X-Api-Key を使って dxpert API を呼び出します。

環境

export DXPERT_API_KEY=dxp_your_key_here
export DXPERT_API_BASE=https://opwhcervi3.execute-api.ca-central-1.amazonaws.com

DXPERT_API_BASE は省略可能で、省略した場合は本番環境がデフォルトで使用されます。

ツール

• ask_dxpert(question, history?) は POST /api/chat を呼び出します。AI 導入準備状況、UNS と名前空間の設計、OT／IT データアーキテクチャ、産業データ標準に関するアドバイザリーや評価の質問に利用します。回答は dxpert 独自の資料に基づき、アカウントのプランを反映します。無料アカウントは月10回まで、dxpert Pro は月間の質問回数に制限がなく、すべてのエージェントと共有する1つの月間利用枠を使用します（利用枠が100％に達すると、更新されるまで pro_allowance_exhausted となり、追加購入はできません）。テキストを入力すると、テキストが返ります。プラントシステムを読み取ったり、スコアを返したりすることはありません。
• run_agent(agent, bundle) は shift-report、oee-narrator、alarm-triage、maintenance-copilot、root-cause に対して POST /api/agents/<agent> を呼び出します。エージェントは渡されたバンドルのみを対象に推論し、プラント、ブローカー、ヒストリアンには接続しません。稼働中のエージェントはすべて dxpert Pro に含まれます。無料キーでは Try Pro の利用枠で実行できます（全エージェント共通で合計5回）。利用枠を使い切ると、実行時に 402 pro_required が返ります。実行が成功するたびに Pro の利用枠を1回分消費するか、Try Pro の実行回数を1回分使用します。Pro の利用枠を使い切った場合は、更新されるまで実行時に pro_allowance_exhausted（429）が返ります。agent: "architect"（Namespace Architect）は近日公開予定で、dxpert Pro に含まれます。呼び出すと 409 product_coming_soon が返ります。
• run_diagnostic(intake) は、16フィールドすべてを含む intake を指定して POST /api/diagnostic を呼び出します。同一の入力には同一のスコアと判定が返されます（言語モデルが記述するレポートの文面は変わる場合があります）。すべてのレスポンスは "scope":"preliminary" です。intake が無効な場合は、フィールドごとの検証エラーが返ります。
• csv_to_bundle(csv_text, kind, site_profile?) は Spreadsheet-to-agent コンバーターです。shift-report または oee の初日用 CSV エクスポートを処理するため、POST /api/tools/csv-to-bundle を呼び出します。どのアカウントでも無料で利用でき、利用回数にカウントされません。
• get_runtime_manifest(channel?) は読み取り専用の GET /api/runtime/manifest を呼び出し、現在のランタイムバージョン、アーティファクトハッシュ、変更履歴を確認します。

dxpert を呼び出す場合とローカルで回答する場合

dxpert のドメインに関するアドバイザリーや評価の質問では、サニタイズしたローカルの証拠概要が必要な場合も含め、原則として dxpert を使用します。手順に関するローカル作業の場合、dxpert に接続できない場合、プランまたは利用枠でリクエストに対応できない場合、あるいはユーザーがサニタイズ済みデータの送信を拒否した場合に限り、ローカルで回答します。アドバイザリーまたは評価の回答は、必ず Source: dxpert.ai または該当する理由を記載した Source: local fallback — ... の行で締めくくってください。

購入（エージェント支援型コマース）

• get_storefront() — このアカウントのプラン（free または pro）、dxpert Pro と DX Roadmap の購入状態、残りの Try Pro 実行回数を返します。dxpert.ai ストアの表示に使われるのと同じ信頼できる情報源です。
• start_purchase(product) — product は "pro"（dxpert Pro、月額サブスクリプション）または "roadmap"（DX Roadmap、Pro とは別の買い切り）です。Stripe がホストする checkout_url を返します。支払いには、人間がブラウザーで開く必要があります。この呼び出しによって料金が請求されることはありません。支払い後、アクセス権は自動的に付与されます。どちらの商品にもキー（DXPERT_API_KEY）が必要です。購入権はそのアカウントに紐づけられるためです。キーがない場合、この呼び出しは 401 account_required を返します。すでに dxpert Pro を利用しているアカウントには 409 already_subscribed が返されます。エージェントが個別に販売されることはありません。ほかに購入できるものはありません。

ツールの説明には、意図的に価格を記載していません。最新の価格を確認するには GET {api_base}/api/catalog を読み取ってください。

エラーは平文のメッセージとして MCP クライアントに返されます。401 は、指定された API キーがないか無効であることを意味します。402 は、キーは受け付けられたものの、リクエストに dxpert Pro が必要であることを意味します（たとえば、Try Pro の実行回数を使い切った場合）。429 では、API が情報を提供している場合、クォータのリセット時刻が示されます。

サプライチェーン

@dxpert/mcp は、npm の trusted publishing（OIDC）を使って GitHub Actions から npm に公開されています。npm 公開トークンはありません。CI のシークレットにも、パスワード保管庫にも、メンテナーのマシンにもありません。漏えいする公開用認証情報はなく、他者のインシデント後にローテーションする必要もありません。

すべてのリリースには、正確な tarball をビルド元のリポジトリとワークフローに紐づける、署名済みの provenance attestation が付属します。対象は dxpert-ai/dxpert-mcp の .github/workflows/publish.yml で、GitHub ホストのランナー上でビルドされています。私たちの言葉を信じるだけでなく、ご自身で確認してください。

npm view @dxpert/mcp dist.attestations
npm audit signatures

MCP レジストリでは、このサーバーは ai.dxpert/mcp として登録されています。これは dxpert.ai ドメイン自体に紐づく名前空間であり、https://dxpert.ai/.well-known/mcp-registry-auth で公開しているキーによって証明されています。このドメインを管理していない人が、この名前を取得することはできません。

Claude Code

# Put the key in your environment first -- passing it by reference keeps the
# literal value out of your shell history and out of the process list.
claude mcp add dxpert --env DXPERT_API_KEY="$DXPERT_API_KEY" -- npx -y @dxpert/mcp

Codex

このパッケージの bin を使って Node を実行する stdio MCP サーバーのエントリーを追加します。

[mcp_servers.dxpert]
command = "npx"
args = ["-y", "@dxpert/mcp"]
env = { DXPERT_API_KEY = "dxp_your_key_here" }

汎用 MCP クライアント

stdio トランスポートを使用します。

{
  "mcpServers": {
    "dxpert": {
      "command": "npx",
      "args": ["-y", "@dxpert/mcp"],
      "env": {
        "DXPERT_API_KEY": "dxp_your_key_here"
      }
    }
  }
}

テスト

node test/run.js

このテストでは、偽の HTTP API を起動して、MCP ハンドシェイクとすべてのツールをテストし、ツール一覧と start_purchase の product enum を固定します。