MCP-Kit
  • 한국어

      • 2. 전체 기술 스택

      프레임워크 및 언어

      항목버전설명
      Node.js>=24.10.0 (.nvmrc 기준)런타임
      TypeScript^5.6.3언어
      pnpm9.12.1패키지 매니저
      Turbo^2.3.3모노레포 빌드 오케스트레이션

      핵심 의존성

      패키지버전용도
      @modelcontextprotocol/sdk^1.29.0MCP 서버 구현 (Server, StdioServerTransport, CallToolResult 등)
      zod^4.4.2도구 입력 스키마 정의 및 런타임 검증

      문서 사이트

      도구버전용도
      Rspress (@rspress/core)^2.0.12문서 사이트 프레임워크 (Vite/Rspack 기반)
      @rspress/plugin-llms^2.0.12llms.txt / llms-full.txt 자동 생성
      Netlifynetlify-cli ^26.0.2문서 사이트 배포

      apps/site/scripts/package-docs-plugin.ts — 패키지 README를 동적으로 문서 페이지로 변환하는 커스텀 Rspress 플러그인

      빌드 및 번들링

      도구용도
      tsup (^8.5.1)TypeScript → ESM 번들링, dts 생성, minify
      Turbo (^2.3.3)모노레포 태스크 실행, 빌드 캐싱, 의존성 그래프 관리

      번들링 설정 공통 사항 (packages/common/build/tsup.config.mjs):

      • ESM 포맷 ("format": ["esm"])
      • @modelcontextprotocol/sdk, zod는 external (번들에 포함하지 않음)
      • @julong/*, @common은 noExternal (내부 모듈이므로 번들에 포함)
      • Minify 활성화 ("minify": true)
      • 각 패키지는 3개의 엔트리 포인트: index.ts, server.ts, cli.ts

      CI/CD

      도구용도
      GitHub ActionsCI, Auto PR, Release 워크플로우
      release-please (googleapis/release-please-action@v4)모노레포 릴리스 자동화 (릴리스 PR 기반 패키지별 독립 버전 관리)
      Conventional Commits버전 결정 기준 (feat/fix/BREAKING CHANGE)
      release-please CHANGELOG패키지별 CHANGELOG.md 자동 생성
      pnpm -r publishnpm 배포 (릴리스 PR 머지 후 publish 잡에서 실행)
      release-please 태그버전 태그 생성 (<package-name>@<version>)
      release-please 릴리스GitHub Release 생성

      릴리스 규칙 (release-please-config.json + .release-please-manifest.json)

      버전 관리는 Conventional Commits를 기준으로 동작합니다. main에 push될 때 즉시 릴리스하는 대신, release-please가 버전 Bump와 CHANGELOG 항목을 담은 릴리스 PR을 열거나 업데이트합니다. 이 PR을 머지하면 태그와 GitHub Release가 생성되고 npm 배포가 트리거됩니다. 패키지별 현재 버전은 .release-please-manifest.json에서 추적됩니다.

      release-please-config.json 주요 옵션: release-type: "node", include-component-in-tag: true, include-v-in-tag: false, separator: "@" (태그는 기존 <package-name>@<version> 형식을 유지, 예: @julong/mono-rele2-core@1.34.0), plugins: ["node-workspace"], 그리고 packages/core, packages/utils, apps/site를 포함하는 packages 맵.

      커밋 타입버전 Bump
      featminor (1.x.0)
      fixpatch (1.0.x)
      perfpatch (1.0.x)
      revertpatch (1.0.x)
      BREAKING CHANGE (footer)major (x.0.0)
      docs, chore, refactor, test, build, ci, style릴리스 없음

      부재 항목 (현재 미사용)

      • 린터: ESLint 설정 없음
      • 포매터: Prettier 설정 없음
      • 테스트 프레임워크: Vitest, Jest 등 테스트 도구 미설정
      • 테스트 파일: *.test.ts 파일 존재하지 않음
      • UI 프레임워크: React, Next.js 등 미사용 (MCP 서버 전용)
      • 데이터베이스: 미사용
      • HTTP 서버: 미사용 (MCP stdio 전송 방식만 사용)