Stackbilt MCP 게이트웨이

MCP 레지스트리: dev.stackbilt.mcp/gateway — 공식 MCP 레지스트리에 게시됨

Stackbilt 플랫폼 서비스를 위한 OAuth 인증 Model Context Protocol(MCP) 게이트웨이입니다. @cloudflare/workers-oauth-provider를 사용하여 Cloudflare Worker로 구축되었습니다.

기능

도구 호출을 여러 백엔드 제품 워커로 라우팅하는 단일 MCP 엔드포인트(mcp.stackbilt.dev/mcp)입니다:

스캐폴드 파이프라인 (E2E)

You: "Build a restaurant menu API with D1 storage"
  ↓
scaffold_create → structured facts + 9 deployable project files
  ↓
scaffold_publish → GitHub repo with atomic initial commit
  ↓
git clone → npm install → npx wrangler deploy → live Worker

파일 생성을 위한 LLM 호출 제로. 구조화에 약 20ms, 오라클 산문에 약 2초 소요. flow_create보다 21배 빠릅니다.

Related MCP server: forgemesh-imagegen

주요 특징

• PKCE를 포함한 OAuth 2.1 — GitHub SSO, Google SSO 및 이메일/비밀번호 인증

• 백엔드 어댑터 패턴 — 충돌을 방지하기 위해 네임스페이스가 지정된 여러 서비스 바인딩에서 집계된 도구 카탈로그

• 티어별 속도 제한 — RATELIMIT_KV를 통한 테넌트별 고정 윈도우 제한(무료=20/분, 하비=60, 프로=300, 엔터프라이즈=1000); Retry-After 및 X-RateLimit-* 헤더와 함께 429 응답

• 비용 귀속 및 할당량 — 모든 도구 호출에는 크레딧 비용이 발생합니다; 할당량은 디스패치 전에 edge-auth를 통해 예약되고 결과에 따라 커밋/환불됩니다; image_generate 비용은 유효 품질 티어에 따라 조정됩니다(드래프트/표준/프리미엄/울트라/울트라_플러스에 대해 1배/1배/3배/5배/8배); model이 설정되면 quality_tier보다 우선하여 과금됩니다

• 범위 + 티어 적용 — tools/list는 토큰 범위에 의해 필터링됩니다; tools/call은 변경 도구에 대해 generate 범위가 필요합니다; 고비용 image_generate 품질 티어(프리미엄 이상)는 Pro+ 플랜으로 제한됩니다; model을 직접 지정하면 모델→티어 매핑을 통해 동일한 제한이 적용됩니다

• 보안 헌법 준수 — 모든 도구는 위험 수준(READ_ONLY, LOCAL_MUTATION, EXTERNAL_MUTATION)을 선언합니다; 비밀 정보가 마스킹된 구조화된 감사 로깅; HMAC 서명된 ID 토큰

• 출시 예정 게이트 — 공개 액세스를 제어하는 PUBLIC_SIGNUPS_ENABLED 플래그

• HTTP 기반 MCP JSON-RPC — 스트리밍(SSE) 및 요청/응답 전송 모두 지원

빠른 시작

사전 요구 사항

• Node.js 18+

• Wrangler CLI (npm i -g wrangler)

• 필요한 서비스 바인딩이 구성된 Cloudflare 계정

설치 및 실행

npm install
npm run dev

테스트 실행

npm test

배포

npm run deploy

Cloudflare Workers를 통해 mcp.stackbilt.dev 커스텀 도메인으로 배포합니다.

환경 변수 및 보안 정보

다음 명령어로 보안 정보를 설정하세요:

wrangler secret put SERVICE_BINDING_SECRET

프로젝트 구조

src/
  index.ts           # Entry point — OAuthProvider setup, CORS, health check, MCP Registry well-known
  gateway.ts         # MCP JSON-RPC transport, session management, tool dispatch
  oauth-handler.ts   # OAuth 2.1 flows: login, signup, social SSO, consent
  tool-registry.ts   # Tool catalog aggregation, namespacing, schema validation
  audit.ts           # Structured audit logging, secret redaction, trace IDs
  auth.ts            # Bearer token extraction & validation
  route-table.ts     # Static routing table, tool-to-backend mapping, risk levels
  types.ts           # Type definitions, RiskLevel enum, interfaces

test/
  audit.test.ts
  auth.test.ts
  gateway.test.ts
  oauth-handler.test.ts
  route-table.test.ts
  tool-registry.test.ts

docs/
  user-guide.md      # End-user guide: account creation, client setup, tool usage
  api-reference.md   # MCP tool surface, authentication flow, tool routing
  architecture.md    # System design, security model, request flow

테스트 스위트

6개 테스트 파일에 걸친 122개의 테스트:

• OAuth 핸들러 — ID 토큰 서명/검증, 로그인, 회원가입, 소셜 OAuth 흐름, 동의, HTML 이스케이프

• 게이트웨이 — 세션 수명 주기, initialize, tools/list, tools/call, SSE 스트리밍, 오류 처리

• 감사 — 비밀 정보 마스킹 패턴(API 키, 베어러 토큰, 16진수 해시, 비밀번호 필드), 추적 ID, 큐 방출

• 인증 — 베어러 토큰 추출, API 키 대 JWT 검증, 오류 매핑

• 도구 레지스트리 — 카탈로그 구축, 이름 매핑, 스키마 검증, 위험 수준 적용

• 라우트 테이블 — 경로 확인, 위험 수준 조회

npm test          # single run
npm run test:watch # watch mode

문서

• 사용자 가이드 — 계정 생성, 클라이언트 설정, 도구 사용법

• API 참조 — MCP 도구, 인증, 도구 라우팅

• 아키텍처 — 시스템 설계, 보안 모델, 데이터 흐름

라이선스

MIT — LICENSE 참조