
audio-plugin-soko-kun
io.github.AllegroMoltoV/audio-plugin-soko-kun
Search, inspect, and submit open-source VST 3, CLAP, LV2, and AU plugins in an unofficial registry.
Documentation
Audio Plugin Soko-kun (音のプラグイン倉庫くん)
VST® is a registered trademark of Steinberg Media Technologies GmbH.
English
Audio Plugin Soko-kun is an independent, open registry of open-source audio plugins in VST 3, CLAP, LV2 and Audio Unit formats. Like its sibling Plugin Soko-kun for OBS Studio, it is designed MCP-first, so AI coding agents such as Claude Code and Codex can search for plugins and register GitHub repositories directly. A read-only web catalog is also provided at https://audio-soko-kun.allegromoltov.jp.
This project is an unofficial service that is not affiliated with Steinberg Media Technologies GmbH, the CLAP project, Apple, or the LV2 project.
Background
Malware disguised as cracked audio plugins has been reported repeatedly, and in 2026 an OBS Studio plugin forum saw author accounts taken over and published files replaced. Audio Plugin Soko-kun does not host files. It links to the files that authors publish on GitHub Releases, and lists a version only if the release is immutable, every file in the release, including installers that are not linked, has a build provenance attestation from the repository's own release workflow, a zip archive contains a VST 3, CLAP, LV2 or Audio Unit bundle and no archive contains a VST 2 plugin, the repository has an OSI- or FSF-approved open-source license at the release tag, no file is a known malware sample in MalwareBazaar, and macOS bundles are signed with a Developer ID and notarized. LV2 bundles for macOS are not linked, because Gatekeeper does not assess them. It also reviews the repository's development practices against published review criteria (in Japanese). Passing the checks does not guarantee that a plugin is safe.
Usage
Connect an MCP client to https://audio-soko-kun.allegromoltov.jp/mcp.
# Claude Code
claude mcp add --transport http audio-plugin-soko-kun https://audio-soko-kun.allegromoltov.jp/mcp
# Codex
codex mcp add audio-plugin-soko-kun --url https://audio-soko-kun.allegromoltov.jp/mcp
Searching and viewing details work without signing in. To register a repository you administer, sign in with GitHub first: run /mcp in Claude Code, or codex mcp login audio-plugin-soko-kun in Codex. Then ask, for example, "Register the audio plugin in this GitHub repository". New releases are picked up automatically. Authors can ask, for example, "Check whether my plugin meets the listing conditions" before a release, and "Is the new release of my plugin listed?" after it.
The listing conditions, the security policy, and how to report a problem are on the website: What is Audio Plugin Soko-kun?, Listing policy, Submit a plugin, Security and disclaimer, Report.
Contents
| Path | Contents |
|---|---|
docs/INDEX.md | Index of the documents |
docs/decisions/ | Architecture decision records |
docs/design/ | Design documents |
docs/glossary.md | Glossary |
docs/operations/ | Operations guides (deployment, admin commands, local development, incident response, backup, MCP Registry listing) |
src/ | Cloudflare Worker: web catalog, MCP server, checks and sync |
public/ | Static files: service logo, sharing image, VST Compatible logo |
migrations/ | D1 schema migrations |
scripts/ | Admin commands and maintenance scripts |
test/ | Automated tests |
.github/workflows/ | CI, deployment and verification workflows run on GitHub Actions |
.github/scripts/ | Scripts run by the verification workflows: archive inspection, macOS signing judgment, network API and document scans |
server.json | Listing definition for the official MCP Registry |
glama.json | Maintainer of the Glama listing |
LICENSE | MIT License |
AI disclosure
Anthropic Claude Code was used for almost the entire development of this service, including research, source code, Cloudflare and GitHub configuration, tests, and documentation. The source code was derived from Plugin Soko-kun, which was also developed with Claude Code. The seed plugin simple-pitchshift-audio was also written with Claude Code, and the author checked it in a DAW. The author decided the requirements and design policies, reviewed the web pages and documents, and approved each deployment and external operation one by one. The author did not perform a rigorous line-by-line human review of the source code.
License
MIT License. See LICENSE. The VST Compatible logo images (docs/images/VST_Compatible_Logo_Steinberg*.png and their copies public/images/vst-compatible*.png) are trademarks of Steinberg Media Technologies GmbH and are not covered by the MIT License.
日本語
音のプラグイン倉庫くんは、VST 3・CLAP・LV2・Audio Unit のオープンソースのオーディオプラグインを掲載する、独立した非公式のレジストリです。OBS Studio 向けの配信プラグイン倉庫くんの姉妹で、MCP を主な操作手段にします。Claude Code や Codex などの AI のコーディングエージェントから、プラグインを探したり、GitHub のリポジトリを登録したりできます。閲覧専用の Web カタログを https://audio-soko-kun.allegromoltov.jp で提供しています。
Steinberg Media Technologies GmbH、CLAP のプロジェクト、Apple、LV2 のプロジェクトとは関係のない非公式のサービスです。
背景
クラック版のオーディオプラグインを装うマルウェアが、繰り返し報告されています。2026 年には、OBS Studio のプラグインの掲示板で作者のアカウントが乗っ取られ、公開中のファイルが差し替えられました。
音のプラグイン倉庫くんは、ファイルを預かりません。作者が GitHub Releases で公開したファイルへ案内します。版を掲載するのは、次の条件をすべて満たすときです。
- リリースが不変 (immutable release) である
- リリースのすべてのファイルに、そのリポジトリのリリースのワークフローによる build provenance の証明がある。案内しないインストーラーも含む
- zip のアーカイブに VST 3・CLAP・LV2・Audio Unit のいずれかのバンドルがあり、どのアーカイブにも VST 2 のプラグインが無い
- リリースのタグの時点のリポジトリのライセンスが、OSI か FSF が認めるオープンソースのライセンスである
- どのファイルも、MalwareBazaar に既知のマルウェアとして登録されていない
- macOS 向けのバンドルに、Developer ID の署名と Apple の公証がある。macOS の LV2 のバンドルは、Gatekeeper が判定しないため案内しない
あわせて、公開した審査の基準にしたがって、リポジトリの開発の実践をレビューします。検査を通っても、プラグインの安全を保証するものではありません。
内容物
| パス | 内容 |
|---|---|
docs/INDEX.md | 文書の索引 |
docs/decisions/ | 設計判断の記録 |
docs/design/ | 設計文書 |
docs/glossary.md | 用語集 |
docs/operations/ | 運用の手順 (配備・管理コマンド・ローカルでの開発・侵害の対応・バックアップ・MCP Registry への登録) |
src/ | Cloudflare Worker の本体。Web カタログ・MCP サーバー・検査と同期 |
public/ | 静的なファイル。サービスのロゴ・共有のときの画像・VST Compatible ロゴ |
migrations/ | D1 のスキーマのマイグレーション |
scripts/ | 管理コマンドと保守用のスクリプト |
test/ | 自動テスト |
.github/workflows/ | GitHub Actions で実行する CI・配備・検証のワークフロー |
.github/scripts/ | 検証のワークフローが実行するスクリプト。アーカイブの中身の検査・macOS の署名と公証の判定・通信の API と文書の照合 |
server.json | 公式の MCP Registry への登録の定義 |
glama.json | Glama の掲載の保守者 |
LICENSE | MIT License |
使い方
MCP クライアントを https://audio-soko-kun.allegromoltov.jp/mcp に接続します。
# Claude Code
claude mcp add --transport http audio-plugin-soko-kun https://audio-soko-kun.allegromoltov.jp/mcp
# Codex
codex mcp add audio-plugin-soko-kun --url https://audio-soko-kun.allegromoltov.jp/mcp
検索と詳細の取得は、サインインなしで使えます。自分が管理するリポジトリを登録するときは、先に GitHub でサインインします。Claude Code では /mcp を、Codex では codex mcp login audio-plugin-soko-kun を実行します。そのうえで「この GitHub リポジトリのオーディオプラグインを登録して」のように話しかけます。新しいリリースは自動で取り込みます。作者は、リリースの前に「このプラグインの掲載の条件を確かめて」、リリースのあとに「新しい版の掲載の状況を確かめて」のように話しかけて確かめられます。
掲載の条件、セキュリティの方針、問題の通報の方法は Web サイトに記載しています。音のプラグイン倉庫くんとは?、掲載ポリシー、プラグインを登録する、セキュリティと免責、通報 を参照してください。
AI 利用開示
本サービスの開発では、調査、ソースコード、Cloudflare と GitHub の設定、テスト、文書を含むほぼすべての工程で Anthropic Claude Code を使用しました。ソースコードは、同じく Claude Code で開発した配信プラグイン倉庫くんをもとにしています。シードのプラグイン simple-pitchshift-audio も Claude Code で書き、作者が DAW で動作を確認しました。要件と設計の方針は作者が決めました。作者は Web の画面と文書を確認し、配備と外部への操作を 1 回ずつ承認しました。ソースコードを 1 行ずつ読む厳密な人間のレビューは行っていません。
ライセンス
MIT License です。LICENSE を参照してください。VST Compatible ロゴの画像 (docs/images/VST_Compatible_Logo_Steinberg*.png と、その複製の public/images/vst-compatible*.png) は Steinberg Media Technologies GmbH の商標で、MIT License の対象外です。
更新履歴
0.1.18 (2026-11-16)
- 画面の下部に、姉妹サービスの配信プラグイン倉庫くん (OBS Studio のプラグイン) へのリンクの 1 行を置きました。表示中の言語を引き継ぎます。配信プラグイン倉庫くんの下部にも、本サービスへの同じ形の 1 行があります。
0.1.17 (2026-11-16)
- 検索で、プラグインの表示名 (宣言ファイルの
name) の語でも見つかるようにしました。これまでは所有者名、リポジトリ名、概要、概要の訳、分類だけを照合しており、リポジトリ名と異なる表示名で探しても見つかりませんでした。MCP のsearch_pluginsとサイトの検索の両方に効きます。配信プラグイン倉庫くんの同じ修正を写しました。
0.1.16 (2026-11-15)
submit_pluginの確認のモードの上限 (GitHub のアカウントごとに直近 24 時間で 5 回) で断るとき、次に使える時刻resumesAtを返します。時刻は、直近 24 時間の利用を新しい順に並べた 5 番目の 24 時間後です。作者の AI が、待つ時間の分からないまま呼び直さないようにするためです。配信プラグイン倉庫くんの 0.2.14 を写しました。
0.1.15 (2026-11-15)
- 通信の API の検出で、拡張子とディレクトリの名前による絞り込みをやめ、
.gitを除くすべてのテキストファイルを探します。#includeで取り込む別の拡張子や大文字の拡張子、buildとtargetの配下に置いた通信の処理を見逃していたためです。JUCE を同梱した作者の誤検出を避けるため、JUCE の配置 (modules/juce_core/) のファイルだけを捨てます。UTF-8 として読めない文字を含む行も当てます。ツリーの全体を読むのを 1 回にまとめ、範囲を広げても探索の時間を延ばさないようにしました。
0.1.14 (2026-11-15)
- 古い版の宣言ファイルを後から判定し直すと、新しい版の宣言で決まった表示名・カテゴリ・配布物の宣言を古い版の値で上書きしていた不具合を直しました。より新しい版に判定済みの宣言があれば、プラグインの値を替えません。古い版の配布物の名前の型が新しい版のファイル名に合わないと、新しい版の配布物が案内から外れ、掲載が旧い版に移っていました。
0.1.13 (2026-11-15)
- 公式の MCP Registry への登録の定義
server.jsonを足しました。名前はio.github.AllegroMoltoV/audio-plugin-soko-kunで、エンドポイントはhttps://audio-soko-kun.allegromoltov.jp/mcpです。登録と更新の手順を 公式 MCP Registry への登録 に記載しました。
0.1.12 (2026-11-15)
- 依存のパッケージを更新しました。実行時に使う
honoを 4.13.18 に、開発用の@cloudflare/vitest-pluginを 1.8.0、@cloudflare/workers-typesを 5.20261110.1、mswを 3.0.5、wranglerを 4.160.1 にしました。Dependabot が作った 2 件の更新を、現在の main に合わせて取り込みました。
0.1.11 (2026-11-15)
- 版やプラグインが管理者の確認待ちになったとき、管理者だけが見られる Discord のチャンネルへ、確認待ちの理由ごとに 1 回通知します。誤検出のたびに審査の規則を緩めず、管理者が気づいて承認できるようにするためです。通知は定期処理の最後に、2 つの検証のワークフローの起動の後で送ります。配信プラグイン倉庫くんの 0.2.13 の該当部分を写しました。
- 通知した理由を記録する表を、マイグレーション
0008_admin_notifications.sqlで足しました。秘密情報DISCORD_WEBHOOK_URLが無い環境では通知しません。
0.1.10 (2026-11-15)
- 乗っ取りの兆候の差分の規則で、細工したパスや行による見逃しを塞ぎました。空白や非 ASCII を含むパスの見出しも必ずファイルの区切りとして扱い、ワークフローの変更を見出しの行で判定します。変更の塊の中では
+++で始まる行も追加の行として照合します。バイナリの削除はdeleted file modeの行だけで判定し、名前がand /dev/nullで終わるファイルの追加を削除と取り違えないようにしました。 - GitHub の呼び出しの
getRulesetsを、配信プラグイン倉庫くんと同じ実装にそろえました。挙動は変わりません。配信プラグイン倉庫くんの 0.2.13 の該当部分を写しました。
0.1.9 (2026-11-15)
- 掲載の後も、既定のブランチの README を 1 日 1 回、審査の基準
no-security-bypassとno-terminal-pasteで照合します。新しい版のレビューはタグの時点の README を照合するため、掲載の後に足された案内を次の版まで検知できなかったためです。照合はダウンロード数の記録と同じ回に行い、記録と照合の 2 件の予算が残らないときは記録ごと次の起動へ回します。 - 最初の照合は基準の記録だけにします。基準に無い案内が現れたとき、README が新たに上限を超えたとき、照合に失敗したときは、管理者が確かめるまでプラグインのどの版も掲載しません。作者には
list_my_pluginsの理由readme_heldとして返します。 - 管理コマンドの
pendingに、この確認待ちのプラグインと当たった行を表示し、approve-readmeで解けるようにしました。マイグレーション0007_readme_watch.sqlで、pluginsにreadme_state・readme_hits・readme_heldの列を足しました。設計書・運用の文書・作者向けのページ (7 言語) を更新しました。配信プラグイン倉庫くんの 0.2.12 を写しました。
0.1.8 (2026-11-15)
- 審査の基準
no-security-bypassとno-terminal-pasteで、README のほかに、リリースノートと README 以外の文書も照合します。リリースノートは同期・登録・ダウンロード数の記録で受け取る本文をその場で照合し、本文は保存しません。承認の後に本文を編集して案内を足した版は、承認を取り消して管理者の確認待ちに戻します。README 以外の文書は、検証のワークフローが通信の検出と同じ取り出しで照合します。照合の型は、Worker と GitHub Actions で共有するファイルsrc/review/guidance-patterns.mjsに移しました。照合の結果が期限までに届かなかった版は、2 つの項目を重大の指摘にします。配信プラグイン倉庫くんの 0.2.10 を写しました。 submit_pluginの確認のモードで、リリースがまだ無いときも、リリースを要る条件を未判定として直し方とともに返します。あわせて、既定のブランチの.audio-soko-kun/config.jsonの形を確かめて返します。不変のリリースは公開の後に直せないため、作者が公開の前に問題に気づけるようにしました。list_my_pluginsの再開の目安の時刻を、版の公開の時刻からの上限にしました。呼ぶたびに時刻が後ろへ動き、検査が延びたと誤って説明される問題を直しました。repository-protectionの直し方に、1 人で開発する作者がブランチの ruleset の例外にリポジトリの管理者を「For pull requests only」で足す設定を書きました。get_pluginとlist_my_pluginsの説明に audio plugin を足しました。以上は配信プラグイン倉庫くんの 0.2.11 を写しました。- 作者向けのページ (7 言語) に、確認のモードのサインイン、下書きのリリースに配布物を添付してから公開する手順、案内の型のルールが否定の文にも当たること、宣言ファイルの最小の例、カテゴリの決め方、CLAP の features をカテゴリに使わないことを書きました。README の導入の手順を LLM が判定するとしていたセキュリティのページの記述を、ルールで判定する実装に合わせて直しました。
/submitの理由の一覧にmacos_lv2_not_guidedを足し、掲載ポリシーに macOS 向けの LV2 を案内しないことを書きました。
0.1.7 (2026-11-15)
- 宣言ファイル
.audio-soko-kun/config.jsonの一部の項目だけを書いた正しい宣言が、照合の段階で不正と判定される不具合を直しました。保存した宣言を読み直すときに、書いていない項目を不正とみなしていました。 - 宣言ファイルの判定をやり直す管理コマンド
retry-declarationを足しました。
0.1.6 (2026-11-15)
- レビューの README を、GitHub がリポジトリの画面に表示するものを GitHub の README の API で取得し、そのパスで照合するようにしました。
README.md以外の名前の README や、.githubとdocsに置いた README で、no-security-bypassとno-terminal-pasteの照合を逃れられた欠陥を直しました。README の上限は 128 KB のままで、LLM には先頭の 32,768 文字だけを渡します。配信プラグイン倉庫くん 0.2.9 と同じ実装です。 - AI Gateway のログで配信プラグイン倉庫くんと消費を区別できるよう、Workers AI の呼び出しにサービス名
audio-plugin-soko-kunのメタデータを付けました。
0.1.5 (2026-11-15)
- README を最初に 128 KB まで読み、
no-security-bypassとno-terminal-pasteで全文を照合するようにしました。読めなかった README は、無い README と同じに扱わず、重大の指摘にします。LLM には README の先頭 32 KB だけを渡します。配信プラグイン倉庫くん 0.2.7 と 0.2.8 と同じ実装です。 - 規則で判定して判定できなかった項目の説明を、すべて「Checked by rules: 」で始め、LLM の指摘と見分けられるようにしました。
- macOS の判定の受け口で、試行を使い切った配布物にも、遅れて届いた判定の結果を受け入れるようにしました。確定した結果は書き換えません。
0.1.4 (2026-11-15)
- macOS 向けのバンドルの署名と公証の判定を始めました。新しいワークフロー
macos-verify.yamlが macOS のランナーで配布物を判定し、spctl --assess --type installがsource=Notarized Developer IDを返したバンドルだけを案内します。ステープルの有無は問いません。署名が無いもの、アドホックの署名だけのもの、Developer ID 以外の証明書で署名したものは案内しません。Developer ID の署名があるのに公証済みと判定されないものは、Apple への照会の失敗と区別できないため 3 回まで判定し直し、その後は管理者の確認を待ちます。 - macOS の LV2 のバンドルは、Gatekeeper が判定しないため案内しないことにしました。Linux のバイナリも持つ LV2 のバンドルは、Linux 向けとして案内します。
dittoで展開する前に zip の項目を確かめ、絶対パス・..・バンドルの外を指すシンボリックリンクを含むアーカイブは展開しないようにしました。フレームワークの中を指すシンボリックリンクは許します。- Worker に、
macos-verify.yamlのトークンだけを受け付ける受け口/internal/macos-checks/pendingと/internal/macos-checks/resultsを加え、定期処理からmacos-verify.yamlも起動するようにしました。版の macOS のバンドルの Team ID が食い違うときは、管理者の確認を待ちます。
0.1.3 (2026-11-15)
- 定期処理で、新しい版の検査を同期より先に行うようにしました。これまでは同期が先に外部呼び出しの予算を使い、同期を待つプラグインが 20 件ほどに増えると、新しい版の検査が毎回飛ばされていました。検査の間も同期 1 件の分を残し、検査が予算を超えても失敗しても同期は進みます。検査で GitHub が 5xx を返し続ける版は試行に数え、2 回で管理者の確認待ちにします。配信プラグイン倉庫くん 0.2.6 の変更に合わせたものです。
- 管理コマンドに
retry-checksを加えました。証明の検証・中身の検査・macOS の判定が 3 回errorで終わった版と、レビューが 2 回失敗した版の検査を、原因を確かめたあとに待ちの状態へ戻せます。管理コマンドpendingには、版の公開からの経過時間waiting_minutesと、試行を使い切った配布物の件数checks_exhaustedを出します。
0.1.2 (2026-11-15)
- 新しい版のソースのコードから通信の API の使用を GitHub Actions で検出し、結果をレビューに事実として渡すようにしました。JUCE と Rust の通信の API も探します。ソースは実行もビルドもしません。通信の API があるのに README が外部への送信に一切触れていない版は、管理者の確認待ちにします。レビューは検出の結果を、版の公開から 6 時間まで待ちます。配信プラグイン倉庫くん 0.2.3 の変更に合わせたものです。
- 新しい版のタグのコミットが既定のブランチの履歴に無ければ、乗っ取りの兆候
tag-not-on-default-branchとして管理者の確認待ちにするようにしました。比べるのはタグの名前ではなく、証明と結び付いた版のコミットです。初めて登録する版にも当てます。推奨の項目に、既定のブランチとリリースのタグを ruleset で守るrepository-protectionを足し、登録の方法のページに設定の仕方を書きました。配信プラグイン倉庫くん 0.2.4 の変更に合わせたものです。
0.1.1 (2026-11-15)
- 本番の Workers AI の呼び出しを、配信プラグイン倉庫くんと共有する AI Gateway に通し、その支出の上限で 2 つのサービスを合わせた費用を止めるようにしました。上限に達したときは、無料枠の不足と同じく、レビューを 1 時間後にやり直し、翻訳を次回に回します。
0.1.0 (2026-11-15)
- 設計文書と設計判断の記録を公開しました。
- 配信プラグイン倉庫くん 0.2.1 のコードをもとに、オーディオプラグイン向けの登録サービスを https://audio-soko-kun.allegromoltov.jp で公開しました。
- VST 3・CLAP・LV2・Audio Unit のバンドルを zip の中から検出する中身の検査と、宣言ファイル
.audio-soko-kun/を加えました。 - 開発の実践のレビューを、ルールで判定する項目と LLM が判定する項目に分けました。差分が大きいだけでは確認待ちにせず、変更されたファイルの一覧から計算した事実で判断します。
- macOS の配布物は、署名と公証の判定を実装するまで案内しません。
No installation packages available.