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 节点声明的能力与其源码实际使用的上下文 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 集成