Servidor MCP Yeoman

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona integración con generadores de Yeoman, lo que permite a los agentes de IA buscar y ejecutar plantillas de Yeoman mediante programación.

Herramientas

Este servidor implementa las siguientes herramientas MCP:

Métodos de búsqueda de plantillas

yeoman_search_templates : busca plantillas de Yeoman en npm
- Parámetros:
  - query (cadena): palabras clave de búsqueda separadas por comas
  - pageSize (número, opcional): Número de resultados a devolver (predeterminado: 20)

Métodos generadores

yeoman_get_generator_options : obtiene las opciones y argumentos necesarios para un generador Yeoman
- Parámetros:
  - generatorName (cadena): Nombre del generador (sin el prefijo 'generator-')
yeoman_generate - Ejecutar un generador de Yeoman
- Parámetros:
  - generatorName (cadena): Nombre del generador (sin el prefijo 'generator-')
  - cwd (cadena): Directorio de trabajo donde debe ejecutarse el generador
  - appName (cadena): el nombre de la aplicación que se creará
  - version (cadena): La versión de la aplicación que se creará
  - options (objeto, opcional): Opciones para pasar al generador
  - args (matriz, opcional): argumentos posicionales adicionales para pasar al generador

Instalación

Instalación mediante herrería

Para instalar mcp-yeoman para Claude Desktop automáticamente a través de Smithery :

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

Prerrequisitos

Node.js (v16 o posterior)
npm o hilo

Instalación del paquete

# 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

Uso con Claude Desktop

Agregue lo siguiente a su claude_desktop_config.json :

Usando npx

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

Node.js directo

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

Reemplace /path/to/mcp-yeoman con la ruta real a su repositorio.

Argumentos de la línea de comandos

El servidor admite los siguientes argumentos de línea de comandos:

--generator-dir <path> : Especifica un directorio persistente para instalar los generadores Yeoman. De forma predeterminada, los generadores se instalan en un directorio temporal que se elimina al finalizar la operación. Usar un directorio persistente puede mejorar el rendimiento en operaciones repetidas con los mismos generadores.

Ejemplo:

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

Ejemplos

Buscar plantillas

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

Obtener opciones de generador

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

Hacer funcionar un generador

// 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
  }
});

Desarrollo

# Install dependencies
npm install

# Start the server in development mode
npm start

# Build the server
npm run build

Manejo de errores

El servidor incluye un manejo integral de errores:

Errores de validación para parámetros no válidos
Detección interactiva de indicaciones y orientación para las opciones requeridas
Registro detallado de errores para depuración
Limpieza automática de directorios temporales (a menos que se utilice --generator-dir)
Propagación segura de errores mediante el protocolo MCP

Licencia

Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios. Al contribuir, por favor:

Bifurcar el repositorio
Crear una rama de características
Envíe una solicitud de extracción con una descripción clara de los cambios
Asegúrese de que todas las pruebas pasen y se mantenga el estilo del código

mcp-yeoman

Integrations