Noodlr plugins

io.github.noodlrstudio由 GitHub 帳號 noodlrstudio 發布v0.2.2更新於 Nov 14, 2026

Build Noodlr Board plugins: Play API docs, schemas, UI kit, scaffolding and review checks.

發布方自己的服務:Pipeline Pal

概覽

AI 產生的概覽

本機 stdio MCP 伺服器,為編碼助理提供 Noodlr Board 外掛文件、schema、UI 元件與主題權杖,以及腳手架和審查檢查。

可以做什麼
  • 產生 Play 節點或 Web 應用橋接外掛專案,可寫入指定目錄或直接回傳檔案
  • 驗證 Play 節點清單、狀態欄位與連接埠,以及 audiframe、舊版 Web 應用和音訊外掛清單
  • 比對 Play 節點宣告的能力與原始碼實際使用的 context API
  • 檢查 CSS 與 Svelte 樣式區塊中應改用主題權杖的顏色字面值
  • 讀取外掛路線、設計規則、能力、Web 應用、提交要求與 UI 元件等參考資源
適用情境
適合在用編碼助理開發或審查 Noodlr Board 外掛時使用,讓助理依真實的外掛 API、schema 和主題權杖撰寫程式,而不是憑猜測,並在提交前執行與審查者相同的檢查。
執行需求
以 stdio 在本機執行,通常透過 npx 從 npm 套件啟動。需要 Node.js 以及能啟動 stdio 伺服器的 MCP 用戶端。不需帳號、API 金鑰或環境變數。工具參數中的相對路徑以伺服器啟動目錄為基準解析。
安裝前請注意
scaffold_plugin 在傳入目錄時會寫入檔案,該目錄必須為空或不存在。驗證與 lint 工具只回報問題;check_capabilities 是靜態啟發式檢查,被標為未使用的能力可能是誤報。此伺服器聲明不傳送任何資料到其他地方,也不需帳號。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Noodlr plugins,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

@noodlrstudio/mcp

A Model Context Protocol server for building Noodlr Board plugins with a coding agent. It gives the agent the plugin contracts, schemas, UI kit and theme tokens, and the checks reviewers run, so it writes plugins against the real API instead of guessing.

It runs locally over stdio. It needs no account and sends nothing anywhere.

Full guide, with a walkthrough that builds a compressor: Building plugins with a coding agent.

Set up

Claude Code:

sh
claude mcp add noodlr -- npx -y @noodlrstudio/mcp

Any other MCP client: run npx -y @noodlrstudio/mcp as a stdio server. For example, in a project .mcp.json:

json
{  "mcpServers": {    "noodlr": { "command": "npx", "args": ["-y", "@noodlrstudio/mcp"] }  }}

Paths in tool arguments are resolved against the directory the server starts in, normally your project.

What it provides

Resources

URIContents
noodlr://docs/overviewPlugin routes, when to use each, and the workflow
noodlr://docs/design-rulesTheming, capability, state and lifecycle rules
noodlr://docs/capabilitiesEvery capability and the context API behind it
noodlr://docs/web-appsWeb apps on audiframe, and the earlier Noodlr bridge
noodlr://schemas/audiframe/manifestThe audiframe client manifest schema
noodlr://docs/submittingWhat a review pull request needs
noodlr://ui/components@noodlrstudio/ui Play node controls and their props
noodlr://theme/tokensThe --noodlr-* tokens for Light and Dark
noodlr://schemas/play-node/manifestPlay node manifest JSON Schema
noodlr://schemas/play-node/definitionPlay node definition JSON Schema
noodlr://schemas/audio-plugin/manifestWAM 2 / Cmajor / WCLAP manifest JSON Schema

Tools

ToolWhat it does
scaffold_pluginCreates a Play node or web app bridge project
validate_play_nodeValidates a manifest, state fields and ports, including defaults
validate_audiframe_manifestChecks an audiframe manifest with audiframe's own validator
validate_web_app_manifestChecks a manifest for the earlier Noodlr bridge
validate_audio_plugin_manifestValidates a curated audio plugin manifest
check_capabilitiesCompares declared capabilities with the context APIs the code uses
lint_themeFinds colour literals that should be --noodlr-* tokens

check_capabilities is a static check. A missing capability is reliable; an "unused" one may be reached in a way the check cannot see, so treat it as a prompt to look.

Prompts

  • create-play-node: build a Play node from an idea, end to end.
  • connect-web-app: make an existing web app playable in a Web App node with audiframe.
  • prepare-for-review: run every check and list what review still needs.

Developing

sh
npm run build   # regenerates the UI catalogue from packages/ui, then compilesnpm test

src/generated/ui-catalogue.ts is generated from packages/ui/src/play-node. Do not edit it by hand.

To call the built server by hand, use scripts/call.mjs (run from the repo root, so paths resolve there):

sh
node packages/mcp/scripts/call.mjs toolsnode packages/mcp/scripts/call.mjs check_capabilities '{"directory":"examples/compressor-play-node"}'

Or open it in the MCP Inspector: npx @modelcontextprotocol/inspector node packages/mcp/dist/bin.js.

Releasing

  1. Bump version in package.json, src/server.ts (SERVER_VERSION) and both places in server.json, and add a CHANGELOG.md entry.
  2. Publish to npm: npm publish in this folder.
  3. In GitHub, run Actions › Publish to MCP Registry › Run workflow. It checks that server.json matches the version on npm, then publishes it to the MCP Registry as io.github.noodlrstudio/noodlr, using GitHub's OIDC identity for the noodlrstudio organization.

mcp-publisher login github run on your own machine can't publish under the organization: it only sees your personal account.

來源:packages/mcp/README.md,提交 7bb1541

工具

7

scaffold_plugin

Scaffold a plugin

Create a new Play node (Svelte, reviewed) or web app bridge plugin (no review). With `directory`, writes the files there (it must be empty or not exist); otherwise returns them.

輸入參數id必填name必填route必填directorydescription

validate_play_node

Validate a Play node definition

Validate a Play node's manifest, state fields and ports against the host's rules, including that state defaults are valid. Pass the objects from your definePlayNode call as JSON.

輸入參數portsstatemanifest必填

validate_audiframe_manifest

Validate an audiframe manifest

Check the manifest passed to createClient from @audiframe/client, using audiframe's own validator, and explain what is wrong. This is the route for new web apps.

輸入參數manifest必填

validate_web_app_manifest

Validate a legacy Noodlr bridge manifest

For apps on the earlier @noodlrstudio/plugin-sdk bridge (createNoodlrWebAppBridge) only; new web apps use audiframe and validate_audiframe_manifest. Returns the manifest as the host will see it.

輸入參數manifest必填

validate_audio_plugin_manifest

Validate an audio plugin manifest

Validate a curated WAM 2, Cmajor or WCLAP plugin manifest, including checksums and ports.

輸入參數manifest必填

check_capabilities

Check declared capabilities

Compare the capabilities a Play node declares with the context APIs its source uses. Reports missing (the host will refuse the call) and unused (reviewers will ask) capabilities. Static heuristic: treat 'unused' as a prompt to check, not proof.

輸入參數declareddirectory必填

lint_theme

Find colour literals

Find hex, rgb(), hsl(), oklch() and named colours in .css files and Svelte <style> blocks. Play nodes must use --noodlr-* tokens so they work in Light and Dark themes.

輸入參數directory必填

版本歷史

1
  1. v0.2.2最新Nov 13, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Plugins 整合