mcp-copilot-studio-server-generator

Power Platform MCP 连接器生成器

生成一个完整的Power Platform自定义连接器，集成模型上下文协议（MCP），用于Microsoft Copilot Studio。此提示创建所有必要的文件，遵循Power Platform连接器标准，并支持MCP可流式HTTP。

说明

创建一个完整的MCP服务器实现，要求如下：

1. 使用Copilot Studio MCP模式：

   • 实现 x-ms-agentic-protocol: mcp-streamable-1.0
   • 支持JSON-RPC 2.0通信协议
   • 在 /mcp 提供可流式HTTP端点
   • 遵循Power Platform连接器结构

2. 模式合规要求：

   • 工具输入/输出中不能有引用类型（Copilot Studio会过滤掉）
   • 仅使用单一类型值（不能是多种类型的数组）
   • 避免枚举输入（会被解释为字符串，而非枚举）
   • 使用基本类型：string、number、integer、boolean、array、object
   • 确保所有端点返回完整URI

3. 包含的MCP组件：

   • 工具：语言模型可调用的函数（✅ Copilot Studio支持）
   • 资源：工具输出的类文件数据（✅ Copilot Studio支持——必须是工具输出才能访问）
   • 提示：特定任务的预定义模板（❌ Copilot Studio尚不支持）

4. 实现结构：

   /apiDefinition.swagger.json  (Power Platform连接器模式)
   /apiProperties.json         (连接器元数据和配置)
   /script.csx                 (自定义代码转换和逻辑)
   /server/                    (MCP服务器实现)
   /tools/                     (单个MCP工具)
   /resources/                 (MCP资源处理器)
   

上下文变量

• 服务器用途：[描述MCP服务器应实现的功能]
• 所需工具：[列出要实现的特定工具]
• 资源：[要提供的资源类型]
• 认证方式：[认证方法：none、api-key、oauth2]
• 宿主环境：[Azure Function、Express.js、FastAPI等]
• 目标API：[要集成的外部API]

预期输出

生成：

1. apiDefinition.swagger.json，包含：

   • 正确的 x-ms-agentic-protocol: mcp-streamable-1.0
   • MCP端点 POST /mcp
   • 合规的模式定义（无引用类型）
   • McpResponse和McpErrorResponse定义

2. apiProperties.json，包含：

   • 连接器元数据和品牌信息
   • 认证配置
   • 策略模板（如果需要）

3. script.csx，包含：

   • 用于请求/响应转换的自定义C#代码
   • MCP JSON-RPC消息处理逻辑
   • 数据验证和处理函数
   • 错误处理和日志记录功能

4. MCP服务器代码，包含：

   • JSON-RPC 2.0请求处理器
   • 工具注册和执行
   • 资源管理（作为工具输出）
   • 适当的错误处理
   • Copilot Studio兼容性检查

5. 单个工具，要求：

   • 仅接受基本类型输入
   • 返回结构化输出
   • 在需要时将资源作为输出包含
   • 为Copilot Studio提供清晰描述

6. 部署配置，用于：

   • Power Platform环境
   • Copilot Studio代理集成
   • 测试和验证

验证清单

确保生成的代码：

• [ ] 模式中无引用类型
• [ ] 所有类型字段均为单一类型
• [ ] 通过字符串加验证处理枚举
• [ ] 资源可通过工具输出获取
• [ ] 完整URI端点
• [ ] 符合JSON-RPC 2.0规范
• [ ] 正确的x-ms-agentic-protocol头
• [ ] McpResponse/McpErrorResponse模式
• [ ] 为Copilot Studio提供清晰的工具描述
• [ ] 兼容生成式编排

示例用法

服务器用途：客户数据管理和分析
所需工具：
  - searchCustomers
  - getCustomerDetails
  - analyzeCustomerTrends
资源：
  - 客户资料
  - 分析报告
认证方式：oauth2
宿主环境：Azure Function
目标API：CRM系统REST API