Stackbilt MCP 网关

MCP 注册表: dev.stackbilt.mcp/gateway — 发布于 官方 MCP 注册表

用于 Stackbilt 平台服务的 OAuth 认证 模型上下文协议 (MCP) 网关。作为 Cloudflare Worker 使用 @cloudflare/workers-oauth-provider 构建。

功能说明

单一 MCP 端点 (mcp.stackbilt.dev/mcp)，将工具调用路由到多个后端产品 Worker：

脚手架流水线 (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，包含 Oracle 文本约 2s。比 flow_create 快 21 倍。

Related MCP server: forgemesh-imagegen

关键特性

• OAuth 2.1 with PKCE — GitHub SSO、Google SSO 以及电子邮件/密码认证

• 后端适配器模式 — 从多个服务绑定聚合工具目录，并进行命名空间隔离以避免冲突

• 分层级速率限制 — 通过 RATELIMIT_KV 实现每租户固定窗口限制（免费版=20/分钟，业余版=60，专业版=300，企业版=1000）；返回 429 状态码及 Retry-After 和 X-RateLimit-* 响应头

• 成本归因与配额 — 每次工具调用均有信用成本；配额在分发前通过 edge-auth 预留，并在结果产生后提交/退还；image_generate 成本随有效质量层级缩放（草稿/标准/高级/超高/超高+ 分别为 1×/1×/3×/5×/8×）；当设置 model 时，其计费优先级高于 quality_tier

• 作用域 + 层级强制执行 — tools/list 根据令牌作用域进行过滤；tools/call 要求具备 generate 作用域才能调用变更类工具；昂贵的 image_generate 质量层级（premium 及以上）仅限 Pro+ 计划；直接指定 model 会通过模型→层级映射强制执行相同的门控

• 安全宪法合规 — 每个工具声明风险等级（READ_ONLY、LOCAL_MUTATION、EXTERNAL_MUTATION）；结构化审计日志包含敏感信息脱敏；HMAC 签名身份令牌

• 即将推出门控 — 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 处理程序 — 身份令牌签名/验证、登录、注册、社交 OAuth 流程、同意、HTML 转义

• 网关 — 会话生命周期、initialize、tools/list、tools/call、SSE 流式传输、错误处理

• 审计 — 敏感信息脱敏模式（API 密钥、Bearer 令牌、十六进制哈希、密码字段）、追踪 ID、队列发射

• 认证 — Bearer 令牌提取、API 密钥与 JWT 验证、错误映射

• 工具注册表 — 目录构建、名称映射、模式验证、风险等级强制执行

• 路由表 — 路由解析、风险等级查找

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

文档

• 用户指南 — 账户创建、客户端设置、工具使用

• API 参考 — MCP 工具、认证、工具路由

• 架构 — 系统设计、安全模型、数据流

许可证

MIT — 参见 LICENSE