MCP 手动家服务器

一个实现模型上下文协议（MCP）的服务器，提供与 Yeoman 生成器的集成，允许 AI 代理程序搜索并运行 Yeoman 模板。

工具

此服务器实现了以下 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 (数组，可选)：传递给生成器的额外位置参数

安装

通过 Smithery 安装

要自动通过 Smithery 安装 mcp-yeoman 用于 Claude Desktop：

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

先决条件

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

使用方法

基本用法

要使用 MCP Yeoman Server，请按照以下步骤操作：

1. 克隆此仓库：

   git clone https://github.com/yourusername/mcp-yeeman.git
   cd mcp-yeeman
   

2. 安装依赖项：

   npm install
   

3. 启动服务器：

   npm start
   

4. 访问控制台以查看日志和状态信息。

高级用法

要配置服务器，请编辑 config.json 文件，然后启动服务器：

npm run start -- --config config.json

错误处理

此服务器包含全面的错误处理：

• 无效参数的验证错误
• 交互式提示检测和指导
• 详细的错误日志记录以供调试
• 暂时目录的安全清理（除非使用 --generator-dir）
• 通过 MCP 协议传播错误

许可证

此 MCP 服务器根据 MIT 许可证发布。这意味着您可以自由地使用、修改和分发软件，但需遵守 MIT 许可证的条款和条件。有关详细信息，请参阅项目存储库中的 LICENSE 文件。

贡献

欢迎贡献！请随意提交 Pull Request。当贡献时，请：

1. 叉克仓库
2. 创建功能分支
3. 提交包含清晰说明更改内容的 Pull Request
4. 确保所有测试通过且代码风格一致