MCP Yeoman 服务器
模型上下文协议 (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自动为 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 文件。
贡献
欢迎贡献代码！请随时提交 Pull 请求。贡献代码时，请注意以下几点：
- 分叉存储库
- 创建功能分支
- 提交拉取请求，并清晰描述变更
- 确保所有测试通过并且代码风格得到维护