mcp-builder-ms

用途：在需要构建 MCP（Model Context Protocol）服务器、把外部 API 或服务接入大模型时使用，覆盖 Python（FastMCP）与 Node/TypeScript（MCP SDK），是微软 MCP 生态相关的开发指南。主要能力与流程分四阶段：一是调研与规划，理解 API 覆盖与工作流工具的取舍、工具命名与可发现性、上下文与分页管理、可操作的错误信息，并查阅 MCP 协议与框架文档；二阶段实现，搭建项目结构、实现 API 客户端与认证、错误处理、响应格式化与分页，使用 Zod（TypeScript）或 Pydantic（Python）定义输入输出 schema，配置 readOnlyHint、destructiveHint、idempotentHint、openWorldHint 等注解；三阶段审查与测试，检查代码质量，TypeScript 用 npm run build 验证并可用 npx @modelcontextprotocol/inspector 测试，Python 用 python -m py_compile your_server.py 校验语法；四阶段编写评测，生成 10 个独立、只读、复杂、可验证且稳定的问答，并按 XML 格式输出。同时说明微软现有服务器（Azure MCP、Foundry MCP、Fabric MCP、Playwright MCP、GitHub MCP）与自建服务器的选择标准。限制：仅在任务匹配上述范围时使用，输出不能替代针对具体环境的验证、测试或专家审查；缺少必要输入、权限、安全边界或成功标准时应先询问澄清。