Symphony

Symphony Codex IPC/MCP とスキル

独立したリポジトリ：QuanuX/symphony-codex-ipc-mpc-and-skills。実装されているプロトコルは MCP（Model Context Protocol） です。過去の移行記録には、以前のリポジトリ名の表記が残されています。ランタイムバージョン：0.1.0-alpha.1。

選択した Symphony インストールを直接管理するための、C++26 製 MCP ブリッジ、Codex スキル／プラグイン、および再利用可能なクライアントアダプターです。公開元：QuanuX、quanux.org。

これは個別に保守されている統合であり、Symphony のモジュールではありません。Symphony のソースコードをチェックアウトせずにビルドでき、明示的に選択した独立インストール済みの qxctl に接続します。移行の来歴には、元のソースと過去のテスト証拠が記載されています。

このブリッジは、選択した qxctl の実際のコマンドレジストリを検出し、正確なコマンドの説明を公開して、読み取りを実行し、設定済みの管理操作をプレビュー／適用します。Symphony の操作インターフェースとして qxctl を維持し、ネイティブの所有者に属する ID、権限、受領記録、バージョン、復旧ルールもそのまま保持します。新たなベクトル依存関係や、必須のワークロード依存関係は追加しません。ユーザーモジュールと構成は、引き続き自由に拡張できます。

これはローカルのアルファ候補であり、OpenAI が承認したディレクトリリリースではありません。現在の互換性は、明示的に固定された MCP 2025-11-25 プロトコルに対応しています。検証、ホスト互換性、公開申請要件を参照してください。

ビルドと接続

要件：macOS または Linux、C++26 ドラフトモード（-std=c++2c）に対応するコンパイラー、CMake 3.30 以降、および設定／テスト用の Python 3.11 以降。Linux では OpenSSL 3 の開発用ファイルも必要です。nlohmann/json 3.12.0 はライセンスとともに同梱されています。ビルド時に依存関係のダウンロードは発生しません。

git clone https://github.com/QuanuX/symphony-codex-ipc-mcp-and-skills.git
cd symphony-codex-ipc-mcp-and-skills
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j 4
ctest --test-dir build --output-on-failure
cmake --install build --prefix "$PWD"

バイナリを bin/ にビルドした後、codex plugin marketplace add "$PWD" で、このチェックアウトに同梱されたマーケットプレイスを登録します。Codex Plugins で Personal → QuanuX — Symphony Codex IPC/MPC and Skills を開き、Symphony をインストールして、セットアップスキルを使って qxctl を選択します。このリポジトリはソースコードであり、クローンしただけではプラットフォーム用の実行ファイルは提供されません。既存のインストール済みデモパッケージは固定されたコピーのままであり、このリポジトリの移動によって置き換えられることはありません。

レジストリに対応した qxctl インストールと、既存の作業ディレクトリを明示的に選択します（リポジトリを検査するコマンドには Symphony リポジトリを使用してください）。

python3 scripts/configure_connection.py \
  --qxctl /absolute/installation/bin/qxctl \
  --working-directory /absolute/Symphony \
  --output /absolute/private/connection.json

python3 scripts/configure_clients.py --client codex \
  --binary /absolute/plugin/bin/symphony-mcp \
  --config /absolute/private/connection.json

2 つ目のコマンドは、クライアント設定の断片を出力します。内容を確認し、対象のホスト設定に追加してください。他の MCP クライアントでは、--client claude、antigravity、または generic を指定します。これらのコマンドはホストにインストールせず、既存の設定を上書きすることもありません。プラグインを完全にインストールした場合は、ホストで文書化されているプラグインデータディレクトリから接続プロファイルを読み込みます。ホスト設定を参照してください。

プロファイルは、デフォルトで読み取り操作のみを許可します。プロファイルの作成時に --enable EXACT_COMMAND_ID を追加すると、エージェントに委任する特定の読み取り以外の操作を公開できます。接続プロファイルでは、固定、環境変数の転送、制限、置き換えについて説明しています。引き続きネイティブの権限が適用されます。commands manifest --json を備えていない古い qxctl は明示的に拒否され、アダプターが自動的にアップグレードすることはありません。

エージェントインターフェース

ツール	目的
symphony_connection	実行ファイル／レジストリのバインディング、ブリッジの制限、および有効な機能。サービスの稼働状況は推測しません
symphony_discover	実際にインストールされているレジストリをページ単位で検索します
symphony_describe	正確なコマンド構文、フラグ、変更可能性、権限、オーナーのプロトコル、および復旧方法を示します
symphony_read	登録済みの読み取り専用操作を直接実行します
symphony_prepare	有効な非読み取り操作に対する、5分間有効でセッションに紐付いた一度限りの引数プレビューを作成します
symphony_apply	そのプレビューを一度実行し、ネイティブの権限を維持しながら、不確実性を保守的に扱います

このパッケージは、接続／使用状況のリソースと symphony-admin プロンプトも公開します。スキルは、実際のオーナーを通じて、検出、管理、ID／監査、ナレッジ、プロバイダー／ハードウェア／ノードのワークフロー、定量的調査、および操作の復旧を案内します。利用可能かどうかは選択したインストール環境によって異なります。コマンドが存在することは、エンジン、認証情報、付与された権限、プロバイダー接続、またはサービスの稼働状況が導入済みであることの証明にはなりません。

トランスポートのプレビューは、ネイティブオーナーのプランではありません。該当する操作では、ネイティブの期待状態チェックと永続的な操作 ID が引き続き不可欠です。出力は上限が設定され、終了コード／stdout／stderr が保持されます。プロセスの終了コード 0 を意味的な成功と同一視することはありません。変更操作中にタイムアウト、応答の喪失、または出力上限への到達が発生した場合、次の操作を行う前にオーナーによる確認／照合が必要です。

オプションのローカル IPC

通常の MCP stdio トランスポートは、すでにローカル IPC です。同じユーザーで明示的に起動する Unix ソケットのフロントエンドも用意されています。

mkdir -m 700 /absolute/private/symphony-ipc
bin/symphony-mcp --config /absolute/private/connection.json \
  --listen /absolute/private/symphony-ipc/bridge.sock

別のプロセスでは、bin/symphony-mcp --connect-socket /absolute/private/symphony-ipc/bridge.sock をホストの stdio サーバーとして起動するか、configure_clients.py --connect-socket ... を使ってそのアダプターを生成します。

両方のピアがカーネルの UID を検証します。ソケットのアクセス権は 0600 で、所有者が管理する 0700 のディレクトリに置かれます。ブリッジはサービスを自動的にインストールしません。一度に処理するローカルセッションは 1 つで、アイドル時間の上限は 60 秒です。これはブリッジのトランスポートであり、qxctl の既存の SSIAG／STAV トランスポートとは別です。Windows の名前付きパイプ、ユーザーをまたぐ委任、およびホスト型 HTTPS MCP エンドポイントは、将来のアダプターとして予定されています。セキュリティとデータの取り扱いを参照してください。

パッケージ化とリリース

ネイティブ MCP バンドル（.mcpb）の配布では、macOS Intel／Apple Silicon および Linux x86-64／ARM64 向けに同じ C++ ランタイムをパッケージ化します。既存のプライベート接続プロファイルが必要で、起動時に Symphony をダウンロード、コンパイル、アップグレード、設定することはありません。要件、正確なパッケージの確認、公式レジストリと GitHub カタログへの個別の公開手順については、MCP レジストリへのインストールと公開を参照してください。Windows ホストでは引き続き明示的な WSL アダプターを使用します。

python3 scripts/package_release.py --binary build/symphony-mcp \
  --output /absolute/output/symphony-alpha-platform.zip

パッケージャーにはソース、選択したバイナリ、スキル、アダプター、ライセンスが含まれます。ローカルプロファイル、ビルドキャッシュ、非公開の証拠は含まれません。アーカイブのダイジェストを出力し、アップロードは行いません。認定済みのプラットフォームごとに、個別のアーティファクトをビルドしてください。ソースのみのアーカイブでは --binary を省略し、インストール前にビルドする必要があります。

OpenAI の公開ローカル MCP 導入経路では、現在パートナーとしての許可リスト登録が必要です。公開者の連絡先、オリジナルのブランド、公開済みプラグインのプライバシーに関する説明、公開者が承認した利用規約を含めています。公開者からデモが提供され、OpenAI のドラフトは 2026 年 10 月 31 日にアップロードされました。コマンドライン MCP の適格性により、正式な OpenAI 審査は引き続き保留中です。この独立した MCP レジストリでの配布は、OpenAI の承認を意味するものではありません。設定済みの C++ ランタイムとアダプターについては、Codex の受け入れ確認に重点的な証拠が記録されています。このパッケージも、テストの成功も、公開開始日を保証するものではありません。

11 件のホスト型プラグイン候補が、プラットフォーム認定チェックに合格しました。対象は、x86-64／ARM64 の Ubuntu、Apple Silicon、Windows から WSL 2 への接続です。Windows クライアントでは明示的な WSL アダプターを使用します。DGX／Spark ハードウェアと、実際のエージェント UI／ネイティブ所有者による受け入れ確認は未完了です。元の検証レポートは、日付入りのベースラインとして引き続き有効です。

マニフェストには、既存のインストール先を選択して、プライベートな固定プロファイルを作成するパッケージ済みの symphony-setup オンボーディングワークフローが追加されました。インストール済みクライアントの証拠と残りの GUI チェックについては、Codex の受け入れ確認を参照してください。NVIDIA DGX／Spark の認定は、後続のマイルストーンです。