Adaptive Cards MCP 是一个 MCP（Model Context Protocol）服务器，旨在帮助 AI 助手为 Teams、Outlook、Copilot 及其他 Microsoft 界面生成有效且无障碍的 Adaptive Cards。项目提供 9 个工具、3 个引导式工作流和 924 个测试。
用途 该服务器让 AI 助手能够以自然语言生成、验证、优化和转换 Adaptive Cards，并针对不同宿主平台进行兼容性处理。它适用于需要快速产出生产级卡片 JSON 的场景，例如审批流程、通知提醒、数据报告、表单输入、个人资料与状态展示等。
主要能力
- 9 个工具：覆盖卡片的生成、验证、优化、转换等操作。
- 3 个引导式工作流（MCP Prompts）：包括生成→验证→优化→宿主配置、将数据转换为卡片、审查现有卡片等。
- 5 个 MCP Resources 和 2 个模板。
- 宿主兼容性：支持 Teams、Outlook、Copilot、ChatGPT 等，并针对 Outlook（v1.4）、Webex（v1.3）自动降级卡片版本。
- 无障碍支持：v2.3.0 起所有生成的卡片自动包含 speak 属性，无障碍评分可达 100/100。
- 输出格式：卡片生成工具返回两个清晰块——可复制的卡片 JSON 和元数据摘要。
- 测试覆盖：924 个测试，包括 28 个工具测试和 10 个提示测试，并带有质量门禁（无障碍评分、元素数量）。
使用方式 无需安装，npx 会自动下载并运行。
- 添加到 AI 助手：
- VS Code：添加到 .vscode/mcp.json
- Cursor：添加到 .cursor/mcp.json
- Windsurf：添加到 ~/.codeium/windsurf/mcp_config.json
- Copilot Studio：打开 Copilot Studio → 你的 agent → Tools → Add a tool → New tool → Model Context Protocol，输入 MCP 服务器 URL（例如 https://your-server.azurewebsites.net/sse），选择要暴露的工具。
- ChatGPT：在设置中启用 Developer mode，进入 Settings → Connectors → Create，输入 MCP 服务器 HTTPS URL。
- 开始使用：用自然语言向 AI 助手描述需求，AI 会选择合适的工具，生成有效卡片、验证并返回可直接粘贴到 Adaptive Cards Designer 预览的生产级 JSON。
- 斜杠命令（MCP prompts）：用于引导式多步骤工作流，例如：
- 生成→验证→优化→宿主配置
- 将数据转换为卡片：分析数据→选择最佳布局→验证输出
- 审查现有卡片：验证 schema + 无障碍→自动修复问题→生成摘要报告
- npm 库（编程方式）：可在自己的代码（机器人、API、CI 管道）中安装该包使用，详见 Library API 参考。
适用场景
- 审批和工作流
- 通知和警报
- 数据和报告
- 表单和输入
- 个人资料和状态
- 跨宿主和版本管理
- 验证和优化
限制与说明
- 通过 MCP 使用时（Claude Code、Copilot、Cursor），宿主 LLM 提供智能，无需 API key。仅在独立/库使用时才需要设置 API key。
- 遥测默认关闭，需主动选择加入。启用后收集匿名使用指标并发送聚合数据到 PostHog。发送内容包括工具名称、调用次数、时长、错误率、平台（OS）、Node 版本、包版本、传输类型；绝不发送卡片内容、用户提示、数据负载、IP 地址、文件路径、环境变量。每次服务器启动生成随机会话 ID，不存储持久标识符。可通过设置 MCP_TELEMETRY=true/false 或编辑 ~/.adaptive-cards-mcp/config.json 控制。
- v2.3.0 更新包括：无障碍 100/100、修复 JSON 换行和标题截断问题、宿主感知生成、CSV 解析修复、遥测 /metrics 端点、列入官方 MCP Registry、E2E 测试套件。
- 相关项目：AdaptiveCards-Mobile（跨平台渲染器）、openclaw-adaptive-cards（使用该库的 OpenClaw AI agent 插件）、Adaptive Cards 官方文档、Adaptive Cards Designer、Adaptive Cards Schema Explorer。
- 更多信息可查看 npm 包、GitHub 仓库和 MCP Registry。
