Metalsmith Plugin MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Metalsmith Plugin MCP Server Create a new plugin called metalsmith-sitemap for generating sitemaps"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Metalsmith Plugin MCP Server
MCP server for scaffolding and validating high-quality Metalsmith plugins.
This MCP (Model Context Protocol) server gives Claude and other AI
clients a small, opinionated toolkit for creating and maintaining
Metalsmith plugins. Scaffolded plugins are ESM-only (Node 22+), use
Biome for unified lint + format, and run tests via the native
node:test runner with native coverage. CommonJS consumers can still
require() ESM-only plugins via Node 22's stable require(esm).
Use it two ways: as an MCP server inside Claude Desktop / Claude Code,
or directly from the terminal with npx.
Documentation
docs/tools.md — per-tool MCP reference (options, examples, validation rules)
docs/cli.md — full CLI command reference
docs/setup.md — installing the server in Claude Desktop or Claude Code
MIGRATION.md — upgrading existing plugins to the current scaffold
CHANGELOG.md / GitHub releases — version history
CONTRIBUTING.md — contributing guidelines
TESTING.md — testing the server locally
RELEASE.md — release process
Related MCP server: packkit-mcp
Installation
npm install -g metalsmith-plugin-mcp-serverOr use directly with npx (no install):
npx metalsmith-plugin-mcp-server --helpQuick start
Scaffold a new plugin:
npx metalsmith-plugin-mcp-server scaffold metalsmith-my-plugin "Processes markdown files" ./pluginsValidate an existing plugin:
npx metalsmith-plugin-mcp-server validate ./metalsmith-my-pluginUse with Claude Code:
claude mcp add metalsmith-plugin npx "metalsmith-plugin-mcp-server@latest" "server"Then in Claude: "Create a Metalsmith plugin called metalsmith-json-feed that generates JSON feeds from markdown files." See docs/setup.md for the full setup, including Claude Desktop config.
Available tools
Tool | What it does |
| Generate a complete plugin (src/, test/, package.json, README.md, CLAUDE.md, GitHub workflows). Use only for new plugins in an empty directory. |
| Check an existing plugin against 17 quality checks (structure, tests, docs, package shape, native methods, marketing language, hardcoded values, etc.) |
| Validation + lint + tests + coverage in one health report |
| Generate config files (biome.json, .release-it.json, .editorconfig, .gitignore) |
| Display a canonical config template (release-it, package-scripts, biome, etc.) |
| List every template the server can hand back |
| Retrieve a specific template file verbatim |
| Add or smart-merge a CLAUDE.md into an existing plugin |
| Detect drift between a plugin and the current scaffold templates |
| Update dependencies via npm-check-updates |
The CLI adds batch-audit for processing every plugin in a directory.
See docs/tools.md for full options, examples, and the complete list of validation checks.
What a scaffolded plugin looks like
A plugin-scaffold call produces:
ESM-only
package.json("type": "module","exports": "./src/index.js") — no build step, nolib/, no microbundlesrc/index.jsusing the two-phase plugin factory patterntest/index.test.jsusingnode:test+node:assert/strictagainst a real Metalsmith instancebiome.jsonfor unified lint + formatNative test coverage via
node --test --experimental-test-coverageREADME.md,CLAUDE.md,docs/THEORY.mdskeletons.github/workflows/test.yml,test-matrix.yml,claude-code.yml.github/dependabot.ymlscripts/release.shfor secure manual releases (gh auth tokenbased)
The scaffold enforces use of Metalsmith's native methods
(metalsmith.debug(), metalsmith.match(), metalsmith.env(),
metalsmith.path()) over external debug, minimatch, process.env,
or path.join.
Validation philosophy
The validate tool returns four categories:
Passed — requirement met
Failed — must-fix
Warnings — quality concern (low coverage, unfilled THEORY.md stub)
Recommendations — optional, with the exact command you can paste
Naming and license are recommendations, never failures — author choice
is respected. Each check lives in its own file under
src/tools/validate/checks/ and is
described in docs/tools.md.
Plugin types
The scaffold supports the three common plugin shapes:
Processor — transforms file contents (markdown rendering, image optimization)
Transformer — reshapes file metadata or structure (permalinks, collections)
Validator — checks files against rules (HTML validation, link checking)
Contributing
See CONTRIBUTING.md. Before any commit:
npm run lint
npm run format
npm testResources
License
MIT © Werner Glinka
Available Tools
7 toolsconfigsC
Generate configuration files following enhanced standards.
Inputs: configs, outputPath.
diff-templateA
Diff a plugin against the current scaffold templates. Reports which files match, are missing, or have drifted (with unified diff snippets). Use to keep aging plugins in sync with the latest scaffold.
Inputs: path, templates.
install-claude-mdA
Install a CLAUDE.md in an existing Metalsmith plugin. Smart-merges the MCP Server Integration section into any existing CLAUDE.md so user customizations survive.
Inputs: path, dryRun, replace.
list-templatesA
List every template the server can hand back via get-template. Call this before guessing a template name.
Inputs: no named parameters.
plugin-scaffoldA
Scaffold a complete Metalsmith plugin (src/, test/, package.json, README.md, CLAUDE.md, GitHub workflows). Use only for NEW plugins in an empty directory — never against an existing project. Pass the user's exact plugin name (do not add a metalsmith- prefix); both name and description are required.
Inputs: name (required), description (required), license, features, +1 more.
update-depsB
Update dependencies in Metalsmith plugin(s) using npm-check-updates.
Inputs: path, major, dryRun, interactive.
validateB
Check an existing Metalsmith plugin against quality standards.
Inputs: path (required), checks, functional.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a clearly distinct purpose: installing CLAUDE.md, scaffolding new plugins, listing templates, validating, generating configs, diffing against templates, and updating deps. No overlap or ambiguity.
All tool names follow a consistent hyphenated lowercase pattern (e.g., install-claude-md, plugin-scaffold). Verbs are clear and naming conventions are uniform throughout.
Seven tools is a well-scoped set for a plugin development server, covering scaffolding, validation, configuration, dependency updates, and template management without being overwhelming or sparse.
The tool set covers the main plugin creation and maintenance lifecycle: scaffold, validate, diff, update deps, install CLAUDE.md. A minor gap is the lack of a tool for running tests or building, but core workflows are well-supported.
Maintenance
Related MCP Connectors
Build and publish pages, manage collections, records and files in a Markerloop workspace.
Design system contracts, docs search, and usage validation for @digitaltableteur components.
mtdt.io MCP: Salesforce DevOps platform connector (metadata deployments, backups and more)
Generate a typed SDK, CLI, and MCP server from any OpenAPI or GraphQL spec, and keep them current.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables scaffolding, validating, and managing plugins for the Motor Agéntico ecosystem, with tools to generate plugin structures and verify compliance with the plugin standard.MIT

packkit-mcpofficial
AlicenseAqualityCmaintenanceLets AI agents scaffold modern npm packages, CLIs, HTTP services, and apps as a native tool. Three tools: inspect the full option/preset schema, preview the generated file tree for a config, and write the project to disk.3119 npm1MIT- AlicenseNot gradedqualityDmaintenanceSwiss-Army developer toolkit, stdio inspector, scaffolding CLI & built-in suite of developer tools for Model Context Protocol (MCP) servers.1MIT
- AlicenseNot gradedqualityCmaintenanceProvides a TypeScript scaffolding that auto-loads drop-in tools, resources, and prompts, and serves them to MCP-compatible clients over stdio or streamable HTTP.MIT