IsingQ Toolkit

English | 简体中文

Das IsingQ Toolkit ist ein lokal ausgeführtes Agent-Tool, das öffentlich von der Beijing Ising Intelligent Technology Co., Ltd. gepflegt wird. Es hilft Agenten, Probleme wie Planung, Routenoptimierung, Portfolio-Optimierung und Graphenoptimierung als QUBO zu formulieren. Nach Bestätigung durch den Benutzer wird die Lösung mit dem eigenen IsingQ-API-Key des Benutzers über die Yupan·Ising-Cloud ausgeführt.

• Modellierungsführung, QUBO-Erzeugung, Validierung und Ergebnisprotokollierung erfolgen auf dem Computer des Benutzers.

• Nur die vom Benutzer bestätigte Lösungsmatrix wird per HTTPS an IsingQ gesendet.

• Unterstützt WorkBuddy, Codex, Claude Code, Cursor, VS Code, Trae und DeepSeek Harness.

• Das Standard-MCP bietet 7 Tools und 13 lokale Resources; das DSH-native Plugin bietet 9 Tools.

• Die Cloud-Plattform-API unterstützt derzeit maximal 2048 QUBO-Binärvariablen.

Vor dem Start: IsingQ-API-Key abrufen

Für echte Lösungsausführung ist ein persönlicher IsingQ-API-Key erforderlich. Wissensabfragen, Modellierungsführung und QUBO-Validierung benötigen keinen API-Key.

1. Öffnen Sie Yupan·Ising-Cloud und registrieren Sie sich oder melden Sie sich mit Ihrem persönlichen Konto an.

2. Gehen Sie in der Plattform zu Einstellungen → API.

3. Klicken Sie auf API erstellen, geben Sie einen gut erkennbaren API-Namen ein und schließen Sie die Erstellung ab.

4. Speichern Sie den API-Key bei der Installation über das sichere Eingabefeld des Betriebssystems.

Der Erstellungspfad der Plattform ist auch in der Beschreibung des Dienstes „Einstellungen" in der Datenschutzrichtlinie der Yupan·Ising-Cloud-Website dokumentiert.

Geben Sie den API-Key nicht in Agent-Chats, Befehlsargumenten, MCP-JSON, Issues oder Protokollen preis. Falls der Key versehentlich offengelegt wurde, löschen Sie den entsprechenden Eintrag unter Einstellungen → API in der Cloud-Plattform und erstellen Sie ihn neu.

Empfohlene Installation: Agent die Skill lesen lassen

Senden Sie den folgenden Text an den aktuellen Agenten:

请从 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 工具。

Die Installation der Skill wählt das aktuelle Betriebssystem und den aktuellen Agenten aus; es werden nicht alle Agenten konfiguriert, nur weil andere Agenten auf dem Computer installiert sind. Bei Trae muss das von der Skill ausgegebene stdio-JSON in die MCP-Einstellungsseite importiert werden.

Eine erfolgreiche Installation sollte Folgendes erfüllen:

• Das Programm ist installiert und wurde per Hash überprüft.

• Ein gültiger API-Key ist lokal vorhanden.

• Der aktuelle Agent hat MCP registriert.

• Nach dem Neustart lädt das Standard-MCP 7 Tools oder das DSH-native Plugin 9 Tools.

Installation aus dem GitHub-Quellcode

Das aktuelle öffentliche Repository kann direkt getestet werden. Erforderlich ist Node.js 18 oder höher:

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 empfängt den API-Key ohne Echo. Anschließend wird nur der tatsächlich verwendete Agent konfiguriert:

isingq-mcp configure-host --name workbuddy

--name unterstützt workbuddy, codex, claude-code, cursor, vscode und generic. Für Trae oder andere Hosts kann die Standardkonfiguration abgerufen und manuell importiert werden:

isingq-mcp config --json

Die generische stdio-Konfiguration lautet wie folgt:

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

Beenden Sie nach der Konfiguration den Agenten vollständig und starten Sie ihn neu.

npm, Release und DSH

Wenn Node.js 18 oder höher vorhanden ist, kann direkt über npm/npx installiert und konfiguriert werden:

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

Ersetzen Sie generic durch das tatsächlich verwendete workbuddy, codex, claude-code, cursor oder vscode; für Trae verwenden Sie weiterhin generic und importieren das ausgegebene stdio-JSON.

Benutzer, die Node.js nicht installieren möchten, können die versionsgebundenen Programme für ihr System von GitHub Releases herunterladen und mit SHA256SUMS verifizieren. Unterstützt werden macOS arm64/x64, Linux arm64/x64 und Windows x64.

DeepSeek Harness verwendet das native Plugin und benötigt keine MCP-Bridge:

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

Aktivieren Sie nicht gleichzeitig das IsingQ-native Plugin und die alte MCP-Bridge im selben DSH-Profil.

Verwendung

Nach Installation und Neustart beschreiben Sie dem Agenten einfach Ihr Problem – Sie müssen sich keine Toolnamen merken:

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

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

Der Agent sollte zuerst die Modellierung und Validierung abschließen und die Variablenzuordnung, Zielfunktion, Nebenbedingungen, Penalties, Matrixzusammenfassung und SHA-256 anzeigen. Erst nach Ihrer ausdrücklichen Bestätigung und über den Bestätigungsdialog des Betriebssystems wird die Lösung eingereicht.

Sie können auch lokales öffentliches Wissen abfragen:

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

Tool-Fähigkeiten

Die Lösungsergebnisse werden gleichzeitig aufbewahrt:

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

• MCP objective, neu berechnet aus QUBO: f(x) = offset + Σ_i Q_ii x_i + Σ_{i<j} Q_ij x_i x_j.

Beide können sich aufgrund von Variablentransformationen, Konstantentermen oder unterschiedlichen Koeffizienten-Definitionen unterscheiden. Die niedrigste Energie bedeutet auch nicht automatisch geschäftliche Machbarkeit, globales Optimum oder spezifische Hardware-Leistung.

Daten und Sicherheit

• Der API-Key wird nur in einer privaten lokalen Datei gespeichert und gelangt nicht in Tool-Parameter oder Chats.

• Modellierungsführung, QUBO-Validierung und öffentliche Wissensabfragen erfolgen lokal.

• Nur isingq_solve_start sendet die Lösungsmatrix nach Benutzerbestätigung.

• API-Anfragen verwenden HTTPS; der Matrix-Upload verwendet kurzzeitige Signaturen und überträgt keinen persönlichen API-Key.

• Lokale Aufzeichnungen speichern Modell, Aufgaben-ID und Ergebnis, jedoch keinen API-Key.

Weitere Grenzen finden Sie in der Security Policy.

Upgrade und mehrere Agenten

• Für ein Upgrade führen Sie die Installations-Skill erneut aus oder installieren Sie npm/Release neu.

• Vorhandene API-Keys und lokale Lösungsaufzeichnungen bleiben erhalten.

• Pro Computer ist nur eine Programminstallation erforderlich; verschiedene Agenten registrieren einfach dasselbe lokale Programm.

• Nach einer Konfigurationsänderung muss der jeweilige Agent vollständig neu gestartet werden.

Bei Problemen

• Kein API-Key: Gehen Sie zu Yupan·Ising-Cloud unter Einstellungen → API → API erstellen.

• Agent zeigt keine Tools an: Bestätigen Sie die Konfiguration, starten Sie den Agenten vollständig neu und genehmigen Sie dessen MCP-Vertrauenshinweis.

• Agent-Sandbox verbietet Schreibzugriff: Autorisieren Sie nur das ausdrückliche Installationsverzeichnis und das Benutzerkonfigurationsverzeichnis; legen Sie den API-Key nicht in das Projektverzeichnis.

• Trae kann nicht automatisch angebunden werden: Führen Sie isingq-mcp config --json aus und importieren Sie es über die Trae-MCP-Einstellungsseite.

• Es wird nur eine NDJSON-Antwort getestet: Dies zeigt lediglich, dass der Prozess erreichbar ist; erst wenn 7 native Tools im Agenten sichtbar sind, ist die Anbindung abgeschlossen.

Entwicklerdokumentation

Architektur, Paketgrenzen, QUBO-Datenvertrag sowie Build- und Release-Prozess finden Sie in docs/DEVELOPMENT.md.

Dieses Projekt verwendet die Apache License 2.0. Diese Lizenz gewährt keine Markenrechte in Bezug auf IsingQ oder Ising Intelligence.