IsingQ Toolkit

English | 日本語

IsingQ Toolkit は北京伊辛智能科技有限公司が公開保守するローカル Agent ツールです。Agent がスケジューリング、経路計画、ポートフォリオ、グラフ最適化などの問題を QUBO として表現し、ユーザー確認後にユーザー自身の IsingQ API Key を使用して玉盘·伊辛云求解を呼び出すことを支援します。

• モデリングガイド、QUBO 生成、検証、結果記録はユーザーのコンピューター上で完了します。

• ユーザーが確認した求解行列のみが HTTPS 経由で IsingQ に送信されます。

• WorkBuddy、Codex、Claude Code、Cursor、VS Code、Trae、DeepSeek Harness をサポートします。

• 標準 MCP は 7 つのツールと 13 のローカル Resources を提供します。DSH ネイティブ Plugin は 9 つのツールを提供します。

• クラウドプラットフォーム API は現在最大 2048 個の QUBO バイナリ変数をサポートします。

開始前：IsingQ API Key の取得

実際の求解には個人の IsingQ API Key が必要です。知識照会、モデルガイド、QUBO 検証には API Key は不要です。

1. 玉盘・伊辛云 を開き、個人アカウントで登録またはログインします。

2. プラットフォームで 設定 → API に進みます。

3. API 作成 をクリックし、識別しやすい API 名を入力して作成を完了します。

4. インストール時にオペレーティングシステムの安全な入力ボックスから API Key を保存します。

プラットフォームの作成パスは、玉盘・伊辛云ウェブサイトのプライバシーポリシー の「設定」サービス説明にも記録されています。

API Key を Agent の会話、コマンドパラメータ、MCP JSON、Issue、ログに送信しないでください。Key が誤って漏洩した場合は、クラウドプラットフォームの 設定 → API に戻り、対応するレコードを削除して再作成してください。

推奨インストール：Agent に Skill を読み込ませる

以下の文章を現在の Agent に送信します：

请从 https://github.com/ising-tech/isingq-toolkit 读取 skills/install-isingq-mcp/SKILL.zh-CN.md，严格遵循该 Skill，帮我安装 IsingQ MCP，并且只接入当前 Agent。不要在对话中索要或显示我的 API Key；需要 Key 时使用系统安全输入框。安装完成后，等我重启 Agent，再验证是否加载出 7 个 MCP 工具。

Skill のインストールは現在のオペレーティングシステムと現在の Agent を選択します。コンピューターに他の Agent がインストールされていても、すべてが設定されるわけではありません。Trae は Skill が出力する stdio JSON を MCP 設定ページにインポートする必要があります。

インストールの成功は以下を満たす必要があります：

• プログラムがインストールされ、ハッシュ検証に合格している。

• ローカルに有効な API Key が存在している。

• 現在の Agent が MCP に登録されている。

• 再起動後に標準 MCP が 7 つのツールを読み込むか、DSH ネイティブ Plugin が 9 つのツールを読み込む。

GitHub ソースからのインストール

現在の公開リポジトリは直接テストできます。Node.js 18 以降が必要です：

git clone https://github.com/ising-tech/isingq-toolkit.git
cd isingq-toolkit
npm ci
npm install -g .
isingq-mcp setup
isingq-mcp self-check --json

isingq-mcp setup は API Key をエコーなしで受け取ります。次に実際に使用する Agent のみを設定します：

isingq-mcp configure-host --name workbuddy

--name は workbuddy、codex、claude-code、cursor、vscode、generic をサポートします。Trae または他の Host は標準設定を取得して手動でインポートできます：

isingq-mcp config --json

汎用 stdio 設定は次のとおりです：

{
  "mcpServers": {
    "isingq": {
      "command": "isingq-mcp",
      "args": ["serve"]
    }
  }
}

設定後は Agent を完全に終了して再起動してください。

npm、Release と DSH

Node.js 18 以降がある場合は、npm/npx で直接インストールおよび設定できます：

npx @ising-tech/isingq-mcp setup
npx @ising-tech/isingq-mcp configure-host --name generic --npx

generic を実際に使用する workbuddy、codex、claude-code、cursor、vscode に置き換えます。Trae は generic のまま使用し、出力された stdio JSON をインポートします。

Node.js をインストールしたくないユーザーは、GitHub Releases から対応するシステムの固定バージョンプログラムをダウンロードし、SHA256SUMS で検証できます。macOS arm64/x64、Linux arm64/x64、Windows x64 をサポートします。

DeepSeek Harness はネイティブ Plugin を使用し、MCP Bridge は不要です：

dsh plugin --profile <profile> add @ising-tech/isingq-dsh-plugin

同じ DSH Profile で IsingQ ネイティブ Plugin と旧 MCP Bridge を同時に有効にしないでください。

使用方法

インストールして再起動した後、ツール名を覚える必要はなく、直接 Agent に問題を説明します：

请把下面的排程问题建成 QUBO。先解释变量、目标函数、约束和 Penalty，等我确认后再调用 IsingQ 求解：

任务 A、B 只能选择一个；选择 A 的收益为 8，选择 B 的收益为 5。

Agent はまずモデリングと検証を完了し、変数マッピング、目的関数、制約、Penalty、行列サマリー、SHA-256 を表示する必要があります。あなたが明確に確認し、オペレーションシステムの確認ボックスを通過した場合のみ、求解が送信されます。

ローカルの公開知識を照会することもできます：

玉盘·伊辛云目前提供什么能力？请给出知识版本、来源和表述边界。

ツール機能

求解結果は同時に保持されます：

• IsingQ provider energy：E(s) = -1/2 · Σ_i Σ_j J_ij s_i s_j - Σ_i h_i s_i。

• MCP が QUBO に基づいて再計算した objective：f(x) = offset + Σ_i Q_ii x_i + Σ_{i<j} Q_ij x_i x_j。

両者は変数変換、定数項、係数の口径が異なるため等しくない場合があります。最低 energy も自動的にビジネス実現可能性、グローバル最適性、特定のハードウェア性能を表すものではありません。

データとセキュリティ

• API Key はローカルのプライベートファイルにのみ保存され、ツールパラメータや会話には入りません。

• モデルガイド、QUBO 検証、公開知識の照会はローカルで完了します。

• isingq_solve_start のみがユーザー確認後に求解行列を送信します。

• API リクエストは HTTPS を使用します。行列アップロードは短期署名を使用し、個人 API Key は含まれません。

• ローカル記録はモデル、タスク ID、結果を保存し、API Key は保存しません。

詳細な境界は Security Policy を参照してください。

アップグレードとマルチ Agent

• アップグレード時はインストール Skill を再実行するか、npm/Release を再インストールします。

• 既存の API Key とローカル求解記録は保持されます。

• 各コンピューターにプログラムを 1 つインストールするだけで済みます。異なる Agent は同じローカルプログラムをそれぞれ登録します。

• 設定を更新した後は、対応する Agent を完全に再起動する必要があります。

問題が発生した場合

• API Key がない：玉盘・伊辛云 の 設定 → API → API 作成 に進みます。

• Agent にツールが表示されない：設定を確認して Agent を完全に再起動し、MCP の信頼プロンプトを承認します。

• Agent サンドボックスが書き込みを禁止：明確なインストールディレクトリとユーザー設定ディレクトリのみを承認します。API Key をプロジェクトディレクトリに置かないでください。

• Trae が自動接続できない：isingq-mcp config --json を実行し、Trae MCP 設定ページからインポートします。

• NDJSON 応答のみがテストされる：これはプロセスがアクセス可能であることを示すだけです。Agent に 7 つのネイティブツールが表示されるまで接続は完了していません。

開発者向けドキュメント

アーキテクチャ、パッケージ境界、QUBO データ契約、ビルドと Release プロセスは docs/DEVELOPMENT.md を参照してください。

このプロジェクトは Apache License 2.0 を使用しています。このライセンスは IsingQ または伊辛智能に関連する商標権を付与しません。