Skip to main content
Glama

MCP Yeoman Server

Third Strand Studio

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

  1. yeoman_get_generator_options - Get the required options and arguments for a Yeoman generator

    • Parameters:

      • generatorName (string): Name of the generator (without 'generator-' prefix)

  2. 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

Related MCP server: CodeAlive MCP

Installation

Installing via Smithery

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

npx @smithery/cli@latest install mcp-yeoman --client claude

Prerequisites

  • Node.js (v16 or later)

  • npm or yarn

Installing the package

# Clone the repository
git clone https://github.com/thirdstrandstudio/mcp-yeoman.git
cd mcp-yeoman

# Install dependencies
npm install

# Build the package
npm run build

Usage with Claude Desktop

Add the following to your claude_desktop_config.json:

Using npx

{
  "mcpServers": {
    "yeoman": {
      "command": "npx",
      "args": ["@thirdstrandstudio/mcp-yeoman"]
    }
  }
}

Direct Node.js

{
  "mcpServers": {
    "yeoman": {
      "command": "node",
      "args": ["/path/to/mcp-yeoman/dist/index.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:

{
  "mcpServers": {
    "yeoman": {
      "command": "node",
      "args": ["/path/to/mcp-yeoman/dist/index.js", "--generator-dir", "/path/to/generator-storage"]
    }
  }
}

Examples

Search for Templates

// Search for React-related templates
const templates = await callTool("yeoman_search_templates", {
  query: "react,typescript",
  pageSize: 10
});

Get Generator Options

// Get options for the React generator
const options = await callTool("yeoman_get_generator_options", {
  generatorName: "react"
});

Run a Generator

// Run the React generator
const result = await callTool("yeoman_generate", {
  generatorName: "react",
  cwd: "/path/to/project",
  appName: "my-react-app",
  version: "1.0.0",
  options: {
    typescript: true,
    sass: true
  }
});

Development

# Install dependencies
npm install

# Start the server in development mode
npm start

# Build the server
npm run build

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

Available Tools

10 tools
analyze_sentimentC

You are a sentiment analysis tool. Based on the provided rationale, analyze the sentiment for the given stock symbol. Please ensure that your analysis is objective and unbiased.

Return the result in the following formatted output.

Inputs: reasoning (required), score (required), sentiment (required), symbol (required).

get_ticker_infoC

Retrieve information about a specific stock symbol using Yahoo Finance API.

Inputs: symbol (required).

get_ticker_newsC

Fetches news articles for a given stock ticker symbol.

Inputs: symbol (required).

get_top_companiesC

Retrieve the top companies in a specific sector.

Inputs: sector (required), top_n (required).

get_top_etfsC

Retrieve the top ETFs in a specific sector.

Inputs: sector (required).

get_top_growth_companiesC

Retrieve the top growth companies in a specific sector.

Inputs: sector (required), top_n (required).

get_top_mutual_fundsB

Retrieve the top mutual funds in a specific sector.

Inputs: sector (required).

get_top_performing_companiesC

Retrieve the top performing companies in a specific sector.

Inputs: sector (required), top_n (required).

search_newsC

Search for news articles using a query string.

Inputs: query (required), news_count.

search_quoteC

Search for quotes using a query string.

Inputs: query (required), max_results.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 10 tools

    Disambiguation4/5

    Most tools have distinct purposes focused on different financial data types (sentiment, ticker info, news, top lists by sector), but there is some overlap between get_ticker_news and search_news which could cause confusion about when to use each. The other tools are clearly differentiated by their target data or function.

    Naming Consistency5/5

    All tools follow a consistent snake_case naming pattern with clear verb_noun structure (e.g., analyze_sentiment, get_ticker_info, search_news). The naming is predictable and readable throughout the set, with no mixing of conventions or styles.

    Tool Count5/5

    With 10 tools, this server is well-scoped for financial data analysis, covering sentiment, ticker information, news, and various top lists by sector. Each tool serves a specific purpose without redundancy, and the count is typical for a domain-focused server.

    Completeness4/5

    The toolset provides comprehensive coverage for financial data retrieval and analysis, including sentiment, ticker details, news, and sector-based rankings. A minor gap is the lack of tools for historical price data or portfolio management, but core workflows for research and monitoring are well-supported.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      A Model Context Protocol server that enhances AI agents by providing deep semantic understanding of codebases, enabling more intelligent interactions through advanced code search and contextual awareness.
      91
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that enables AI applications to access and analyze local code repositories without manual uploads, providing file listing, content reading, code searching, and project structure analysis capabilities.
      7
      MIT