mcp-yeoman

MCP Yeoman Server

A Model Context Protocol (MCP) server that provides integration with Yeoman generators, allowing AI agents to search for and run Yeoman templates programmatically.

Tools

This server implements the following MCP tools:

Template Search Methods

1. yeoman_search_templates - Search for Yeoman templates on npm
   • Parameters:
     • query (string): Search keywords separated by commas
     • pageSize (number, optional): Number of results to return (default: 20)

Generator Methods

2. yeoman_get_generator_options - Get the required options and arguments for a Yeoman generator
   • Parameters:
     • generatorName (string): Name of the generator (without 'generator-' prefix)
3. yeoman_generate - Run a Yeoman generator
   • Parameters:
     • generatorName (string): Name of the generator (without 'generator-' prefix)
     • cwd (string): Working directory where the generator should run
     • appName (string): The name of the application to create
     • version (string): The version of the application to create
     • options (object, optional): Options to pass to the generator
     • args (array, optional): Additional positional arguments to pass to the generator

Installation

Installing via Smithery

To install mcp-yeoman for Claude Desktop automatically via Smithery:

Prerequisites

• Node.js (v16 or later)
• npm or yarn

Installing the package

Usage with Claude Desktop

Add the following to your claude_desktop_config.json:

Using npx

Direct Node.js

Replace /path/to/mcp-yeoman with the actual path to your repository.

Command-line Arguments

The server supports the following command-line arguments:

• --generator-dir <path>: Specify a persistent directory for installing Yeoman generators. By default, generators are installed in a temporary directory that is removed when the operation completes. Using a persistent directory can improve performance for repeated operations with the same generators.

Example:

Examples

Search for Templates

Get Generator Options

Run a Generator

Development

Error Handling

The server includes comprehensive error handling:

• Validation errors for invalid parameters
• Interactive prompt detection and guidance for required options
• Detailed error logging for debugging
• Automatic cleanup of temporary directories (unless using --generator-dir)
• Safe error propagation through MCP protocol

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. When contributing, please:

1. Fork the repository
2. Create a feature branch
3. Submit a pull request with a clear description of changes
4. Ensure all tests pass and code style is maintained