MCP Yeoman 서버

Yeoman 생성기와 통합을 제공하는 MCP(Model Context Protocol) 서버로, 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 (배열, 선택 사항): 생성기에 전달할 추가 위치 인수

Related MCP server: MCP YAML API

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 mcp-yeoman을 자동으로 설치하려면:

지엑스피1

필수 조건

• 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 파일을 참조하세요.

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요. 기여 시 다음 사항을 기재해 주세요.

1. 저장소를 포크하세요

2. 기능 브랜치 생성

3. 변경 사항에 대한 명확한 설명과 함께 풀 리퀘스트를 제출하세요.

4. 모든 테스트가 통과되고 코드 스타일이 유지되는지 확인하세요.