metalsmith-plugin-mcp-server

MCP server for scaffolding and validating high-quality Metalsmith plugins

[![metalsmith:plugin][metalsmith-badge]][metalsmith-url] [![npm: version][npm-badge]][npm-url] [![license: MIT][license-badge]][license-url] [![test coverage][coverage-badge]][coverage-url] [![ESM/CommonJS][modules-badge]][npm-url] [](https://snyk.io/test/npm/metalsmith-plugin-mcp-server)

This MCP (Model Context Protocol) server provides tools for creating and maintaining Metalsmith plugins following quality standards. It encapsulates patterns from the Metalsmith ecosystem, such as @metalsmith/core-plugin and contributed plugins like metalsmith-optimize-images.

Simplified Release Architecture - Streamlined release process using GitHub's native features:

• Removed custom release-notes.sh script in favor of GitHub's auto-generated release notes
• Simplified .release-it.json configuration with autoGenerate: true
• IDE compatibility fix: release scripts clear GITHUB_TOKEN to prevent conflicts with VSCode/Claude Code
• Reduced maintenance burden with fewer custom scripts to manage

npm install -g metalsmith-plugin-mcp-server

Or use directly with npx (no installation required):

npx metalsmith-plugin-mcp-server --help

The MCP server provides eight main tools:

Generate a complete Metalsmith plugin structure with enhanced standards:

await mcp.call('plugin-scaffold', {
  name: 'my-feature', // Uses exact name provided
  description: 'Processes and transforms content based on custom rules',
  features: ['async-processing', 'background-processing', 'metadata-generation'],
  outputPath: './plugins'
});

This creates a fully-configured plugin with:

• Dual Module Support: Both ESM and CommonJS builds using microbundle
• Native Metalsmith Methods