MCP ヨーマン サーバー

Yeoman ジェネレーターとの統合を提供し、AI エージェントが Yeoman テンプレートをプログラムで検索して実行できるようにするモデル コンテキスト プロトコル (MCP) サーバー。

ツール

このサーバーは、次の MCP ツールを実装します。

テンプレート検索方法

1. yeoman_search_templates - npm で Yeoman テンプレートを検索

   • パラメータ:

     • query （文字列）：カンマで区切られた検索キーワード

     • pageSize (数値、オプション): 返される結果の数 (デフォルト: 20)

ジェネレータメソッド

2. yeoman_get_generator_options - Yeomanジェネレータに必要なオプションと引数を取得します

   • パラメータ:

     • generatorName (文字列): ジェネレータの名前（'generator-' プレフィックスなし）

3. yeoman_generate - Yeomanジェネレータを実行する

   • パラメータ:

     • generatorName (文字列): ジェネレータの名前（'generator-' プレフィックスなし）

     • cwd (文字列): ジェネレーターが実行される作業ディレクトリ

     • appName (文字列): 作成するアプリケーションの名前

     • version (文字列): 作成するアプリケーションのバージョン

     • options (オブジェクト, オプション): ジェネレータに渡すオプション

     • args (配列、オプション): ジェネレータに渡す追加の位置引数

Related MCP server: MCP YAML API

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の mcp-yeoman を自動的にインストールするには:

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

前提条件

• Node.js (v16以降)

• npmまたはyarn

パッケージのインストール

# 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

Claude Desktopでの使用

claude_desktop_config.jsonに以下を追加します。

npxの使用

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

直接Node.js

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

/path/to/mcp-yeomanリポジトリへの実際のパスに置き換えます。

コマンドライン引数

サーバーは、次のコマンドライン引数をサポートしています。

• --generator-dir <path> : Yeomanジェネレーターをインストールするための永続的なディレクトリを指定します。デフォルトでは、ジェネレーターは一時ディレクトリにインストールされ、操作が完了すると削除されます。永続的なディレクトリを使用すると、同じジェネレーターを繰り返し使用する際のパフォーマンスが向上します。

例：

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

例

テンプレートを検索

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

ジェネレータオプションを取得する

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

発電機を動かす

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

発達

# Install dependencies
npm install

# Start the server in development mode
npm start

# Build the server
npm run build

エラー処理

サーバーには包括的なエラー処理が含まれています。

• 無効なパラメータの検証エラー

• 必要なオプションのインタラクティブなプロンプト検出とガイダンス

• デバッグのための詳細なエラーログ

• 一時ディレクトリの自動クリーンアップ（--generator-dir を使用していない場合）

• MCPプロトコルによる安全なエラー伝播

ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。貢献の際は、以下の点にご注意ください。

1. リポジトリをフォークする

2. 機能ブランチを作成する

3. 変更内容を明確に記述したプルリクエストを送信します

4. すべてのテストが成功し、コードスタイルが維持されていることを確認する