用途
本技能是面向 TypeScript mcp-use/server 服务器的架构标准，用于决定文件应放在哪里、每一层可以导入什么、bootstrap 负责装配什么，以及如何强制执行这种纪律。它聚焦结构性放置问题：当任务涉及 mcp-use/server 仓库内部的结构归属时，由本技能负责；若属于放置之外的机械配方（具体 API、认证、传输、widget 等），则路由到 build-mcp-use-server。
主要能力
- 提供规范目录布局：domain/、application/、handlers/、gateways/、presenters/、infrastructure/、resources/、prompts/、shared/。
- 定义导入矩阵，明确各层可导入与禁止导入的来源，并作为 CI 阻断门禁。
- 规定组合根（src/infrastructure/server/bootstrap.ts）与唯一配置接缝（src/infrastructure/config/runtime-config.ts）。
- 规定 MCP 原语的结构归属：工具处理器、输入 schema、资源、提示、响应塑形、MCPServer 构造、认证/会话/传输接线等。
- 提供请求流程说明：handler 解析 schema 并解析请求上下文，use case 接收已验证命令与端口，gateway 包装外部系统并分类提供方错误，presenter 渲染 MCP 响应并脱敏。
- 提供审计气味清单（如 domain/ 导入 mcp-use、process.env 出现在配置接缝之外、console.* 等）与只读审计脚本。
- 提供多种模式：Greenfield、Refactor、Review、Implementing、Ask，并对应不同参考文档。
使用方式
编辑前先选择一种模式：Greenfield（尚无 src/ 或仅有包存根）、Refactor（存在单体工具、缺少应用层、环境读取分散、业务逻辑中出现协议导入）、Review（需要对仓库或 PR 做结构评级）、Implementing（在干净分层仓库中新增工具、资源、提示或边界组件）、Ask（仅咨询，不做编辑）。根据模式阅读对应参考文档，如 references/greenfield-walkthrough.md、references/refactor-playbook.md、references/audit-checklist.md、references/define-tool-pattern.md、references/handler-context.md。
适用场景
- 判断某个工具、网关、presenter 或端口应放在哪一层。
- 将单体 src/tools/*.ts 重构为清晰分层。
- 审计 MCP 服务器架构或进行 PR 分层审查。
- 为 mcp-use 服务器设置 dependency-cruiser。
- 排查为何 domain/ 或 application/ 中导入了 mcp-use。
- 从零搭建具有正确目录结构的 mcp-use/server 仓库。
- 修复 process.env 在代码库中到处读取的问题。
- 设计端口、适配器与提供方错误分类。
限制
- 不适用于原始 @modelcontextprotocol/sdk 服务器机制问题。
- 不适用于 mcp-use/server API 配方（工具辅助函数、认证、会话、传输、widget、CSP、Inspector、部署）。
- 不适用于客户端应用或 MCPAgent 相关工作。
- 不涉及通用智能体可用性、token 成本、工具描述质量或运行时 UX，这些超出本结构性技能范围。
- 具体收费、价格、平台等信息暂未提供。