企业级MCP服务器开发框架

作者:promptpacks发布日期:2026-09-21观看:25

面向企业内部系统的 TypeScript 版 MCP 服务器完整工程模板,支持 stdio 与 Streamable HTTP 双传输, 内置鉴权、韧性、可观测与审计能力。适用于团队把内部 API 与数据能力安全开放给 AI 编程助手的场景。

01/ 01

你是一名资深分布式系统工程师,请基于 MCP 2025-06-18 规范,使用 TypeScript 为 {{业务系统名称}} 设计并实现可生产部署的 MCP 服务器。 目标用户是 {{使用团队与角色}},需同时支持 stdio(本地 IDE)与 Streamable HTTP(远程智能体)两种传输,会话可断线恢复。 请严格按以下模块顺序交付,每完成一个模块需等待我书面确认后再继续: 模块一 架构:输出组件图与时序图、请求生命周期、能力协商、鉴权边界与安全/可用性风险清单。 模块二 工程脚手架:Node 22 ESM、TypeScript strict、Zod 校验、pino 结构化日志、配置加载与非 root 的 distroless 多阶段镜像。 模块三 工具实现:至少实现只读查询、游标分页列表、需二次确认的写操作三类工具,并标注 readOnlyHint/destructiveHint/idempotentHint。 模块四 资源与提示词:参数化资源模板、订阅变更通知、两个带参数校验的可复用提示词。 模块五 数据模型:核心实体、缓存键与 ETag、游标编码与上游变更时的失效规则。 模块六 韧性设计:JSON-RPC 错误映射、超时、抖动退避、按上游熔断与取消信号传播。 模块七 安全与审计:OAuth 2.1、按工具的权限域、PII 脱敏、运行时注入密钥、只增审计日志。 模块八 测试:Vitest 单元测试、双传输集成测试、Schema 快照、输入模糊测试与规范符合性矩阵。 模块九 部署:K8s 清单(Deployment/Service/HPA)、优雅停机、健康探针、OpenTelemetry 指标与故障处置手册。 交付物含 README(快速开始、HTTP curl 示例、调试指南、安全检查清单),公开接口禁止 any,CI 须覆盖类型检查、Lint、测试与镜像构建。 在开始编码前,请先就合规约束与部署拓扑提出五个澄清问题。

🔥热搜词

评论0

登录后参与评论

还没有评论,来抢沙发吧