⚙️ wheel-hub

바퀴를 다시 발명하려 하지 마세요. 코드 한 줄을 작성하기 전에 최고의 오픈소스 솔루션을 검색하고, 점수를 매기고, 채택하세요.

wheel-hub는 AI 코딩 에이전트와 사람 모두가 오픈소스 생태계를 먼저 확인하도록 만드는 MCP 서버 + CLI입니다. 기능이나 문제가 주어지면 기존 솔루션을 찾아 인기도, 모멘텀, 유지보수성, 신뢰도를 기준으로 점수를 매긴 뒤 adopt, adapt, inspect, avoid 중 무엇을 할지 알려줍니다.

왜 필요한가

모든 개발자(그리고 모든 AI 에이전트)는 인증, 스케줄러, 스크래퍼, 관리자 패널을 처음부터 다시 만듭니다. 더 나은 바퀴가 존재하지 않아서가 아니라, 먼저 찾아보는 사람이 없기 때문입니다. wheel-hub는 '먼저 찾아보기'를 기본값으로 만듭니다.

Related MCP server: reuse-before-generate

설치

MCP 서버 (Claude Code, opencode, Cursor 등)

npx @wheel-hub/mcp

Claude Code 예시:

claude mcp add wheel-hub --env GITHUB_TOKEN=ghp_xxx -- npx @wheel-hub/mcp

일반적인 JSON 설정 예시(대부분의 MCP 클라이언트에서 동작):

{
  "mcpServers": {
    "wheel-hub": {
      "command": "npx",
      "args": ["@wheel-hub/mcp"],
      "env": { "GITHUB_TOKEN": "ghp_xxx" }
    }
  }
}

참고: MCP 클라이언트는 서버에 허용 목록(whitelist)에 있는 환경 변수만 전달합니다. 클라이언트의 env 설정을 통해 GITHUB_TOKEN을 명시적으로 전달하지 않으면 서버는 인증 없이 시간당 60회 요청으로 실행되어 곧 속도 제한에 도달합니다.

그런 다음 에이전트에게 이렇게 물어보세요: "구현하기 전에 wheel-hub로 백그라운드 작업 스케줄링에 이미 무엇이 있는지 확인해 봐".

CLI (사람용)

# one-off
npx @wheel-hub/cli find "SSO login" --lang typescript
npx @wheel-hub/cli evaluate ollama/ollama

# or install for the `wheel-hub` command
npm i -g @wheel-hub/cli
wheel-hub find "SSO login"

도구

점수 산정 모델

네 가지 차원에 가중치를 둔 종합 점수(0–100):

• 인기도 (30%) — 로그 스케일의 스타 수

• 모멘텀 (25%) — 일별 스타 증가 + 최근 푸시 여부

• 유지보수성 (30%) — 커밋 최신성 + 이슈 백로그 비율

• 신뢰도 (15%) — 라이선스 허용 정도, 보관(archived) 상태

판정: ≥75 adopt · ≥55 adapt · ≥35 inspect · <35 / archived avoid

설정

GITHUB_TOKEN (선택) — GitHub API 요청 한도를 시간당 60회에서 5,000회로 올려줍니다. 실제 사용에는 강력히 권장됩니다. 전달 방법은 위의 MCP 설정을 참고하세요.

패키지

로드맵

• NOASSERTION 저장소에 대한 라이선스 폴백: 라이선스 파일 자체를 파싱 (예: 커널의 COPYING은 GPL-2.0을 명시하지만 GitHub는 "Other"로 분류함)

• 보조 신호 소스로 Awesome-list 마이닝

• OSSInsight 데이터를 통한 스타 이력 곡선

• wheel-hub watch — 스택의 의존성이 낡으면 알림 받기

• 점수 저장 + 주간 다이제스트

라이선스

MIT