Yeoman

🚀 MCP 手動家服務器

一個實現模型上下文協議（MCP）的服務器，它提供了與 Yeoman 生成器的集成能力，能夠讓 AI 代理程序搜索並運行 Yeoman 模板，為開發工作帶來便利。

✨ 主要特性

此服務器實現了以下 MCP 工具，為開發者提供了強大的功能支持：

模板搜索方法

• yeoman_search_templates：可在 npm 上搜索 Yeoman 模板。
  • 參數：
    • query (字符串)：由逗號分隔的關鍵字。
    • pageSize (數字，可選)：每頁返回的結果數（默認值：20）。

生成器方法

• yeoman_get_generator_options：用於獲取 Yeoman 生成器所需的選項和參數。
  • 參數：
    • generatorName (字符串)：生成器的名稱（不帶“generator-”前綴）。
• yeoman_generate：運行 Yeoman 生成器。
  • 參數：
    • generatorName (字符串)：生成器的名稱（不帶“generator-”前綴）。
    • cwd (字符串)：生成器運行的工作目錄。
    • appName (字符串)：要創建的應用程序的名稱。
    • version (字符串)：要創建的應用程序版本。
    • options (對象，可選)：傳遞給生成器的選項。
    • args (數組，可選)：傳遞給生成器的額外位置參數。

📦 安裝指南

通過 Smithery 安裝

若要自動通過 Smithery 安裝 mcp - yeoman 用於 Claude Desktop，可使用以下命令：

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

先決條件

• Node.js (v16 或更高版本)
• npm (Node 包管理器)

💻 使用示例

基礎用法

若要使用 MCP Yeoman Server，可按以下步驟操作：

# 克隆此倉庫
git clone https://github.com/yourusername/mcp-yeeman.git
cd mcp-yeeman

# 安裝依賴項
npm install

# 啟動服務器
npm start

之後，訪問控制檯即可查看日誌和狀態信息。

高級用法

若要配置服務器，可編輯 config.json 文件，然後使用以下命令啟動服務器：

npm run start -- --config config.json

🔧 技術細節

此服務器包含全面的錯誤處理機制：

• 對無效參數進行驗證錯誤處理。
• 進行交互式提示檢測和指導。
• 提供詳細的錯誤日誌記錄，方便調試。
• 對暫時目錄進行安全清理（除非使用 --generator-dir）。
• 通過 MCP 協議傳播錯誤。

📄 許可證

此 MCP 服務器根據 MIT 許可證發佈。這意味著您可以自由地使用、修改和分發軟件，但需遵守 MIT 許可證的條款和條件。有關詳細信息，請參閱項目存儲庫中的 LICENSE 文件。

🤝 貢獻

歡迎大家貢獻代碼！請隨意提交 Pull Request。貢獻時，請按以下步驟操作：

1. 叉克倉庫。
2. 創建功能分支。
3. 提交包含清晰說明更改內容的 Pull Request。
4. 確保所有測試通過且代碼風格一致。