Yeoman

MCP Yeoman サーバー

Yeoman ジェネレーターとの連携を提供する Model Context Protocol（MCP）サーバーです。AI エージェントが Yeoman テンプレートをプログラムから検索して実行できます。

ツール

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

テンプレート検索メソッド

1. yeoman_search_templates - npm で Yeoman テンプレートを検索します
   • パラメーター：
     • query（string）：カンマ区切りの検索キーワード
     • pageSize（number、任意）：返す結果の件数（デフォルト：20）

ジェネレーターメソッド

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

   • パラメーター：
     • generatorName（string）：ジェネレーター名（generator- プレフィックスを除く）

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

   • パラメーター：
     • generatorName（string）：ジェネレーター名（generator- プレフィックスを除く）
     • cwd（string）：ジェネレーターを実行する作業ディレクトリ
     • appName（string）：作成するアプリケーション名
     • version（string）：作成するアプリケーションのバージョン
     • options（object、任意）：ジェネレーターに渡すオプション
     • args（array、任意）：ジェネレーターに渡す追加の位置引数

インストール

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 License の下でライセンスされています。これは、MIT License の利用規約に従うことを条件として、ソフトウェアを自由に使用、変更、配布できることを意味します。詳細については、プロジェクトリポジトリの LICENSE ファイルをご覧ください。

貢献

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

1. リポジトリをフォークする
2. 機能ブランチを作成する
3. 変更内容を明確に説明したプルリクエストを送信する
4. すべてのテストが成功し、コードスタイルが維持されていることを確認する