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. 确保所有测试通过且代码风格一致。