项目文档

📦 项目概述

这是一个演示如何使用自定义 MCP 服务器与 Copilot Studio 集成的示例项目。该服务器部署在 Microsoft Azure 上，并专为演示目的设计。此组件不是任何官方微软产品的一部分，也不适用于生产环境。

🔧 如何运行本地开发环境

🚀 启动命令

npm install && npm run dev

🛠️ 项目结构

src/
├── controller.js         # 控制器逻辑
└── routes.js            # 路由定义

🏡 部署到 Azure 的示例

✅ 创建 Azure App Service（Node.js 18+）

设置启动命令（如果需要）：

npm run build && npm run start

🔧 自定义域配置

将以下 DNS 条目添加到自定义域名的解析设置中：

📋 项目依赖

{
  "dependencies": {
    "express": "^4.18.2",
    "ws": "^7.5.0"
  },
  "devDependencies": {
    "typescript": "^5.3.2",
    "typescript-antd-dsl": "^4.16.0"
  }
}

📄 文档

🛠️ 启动本地服务

npm run dev

🔍 如何验证 SSE 服务器是否正常运行

步骤 1：访问 SSE 端点

• 在浏览器中打开：http://localhost:3000/sse（本地）或 Azure 部署的 URL。
• 打开开发者工具 → 网络标签。
• 检查是否有 EventStream 连接。
• 在 Event 标签下，应看到：
  • 端点：SSE 端点
  • 数据：完整的 URI 端点

步骤 2：使用 Postman 测试 SSE 端点

1. 复制完整的 URI（从 EventStream data 中）。
2. 在 Postman 中发送一个 POST 请求到该 URI。

示例 URL：

http://calculatormcp-dummyurl.azurewebsites.net/mcpfy/v1/calculatordemo?sessionId=620c84e1-81e2-484d-8737-a7fbc93165b1

示例请求正文：

{
  "jsonrpc": "2.0",
  "id": "2",
  "method": "tools/call",
  "params": {
    "name": "calculate-bmi",
    "arguments": {
      "weightKg": 180,
      "heightM": 1.8
    }
  }
}

如果成功，您将收到一条带有 "message" 的响应，确认服务器正常运行。

📋 注意事项

• 不支持：此为实验性质的自定义 MCP 服务器，非微软官方产品。
• 仅限演示：专为与 Copilot Studio 集成设计，仅供演示和测试使用。
• 生产环境禁用：不适合用于生产环境。

⚠️ 重要提示： 此为示例自定义 MCP 服务器，仅供演示目的。它已部署到 Microsoft Azure，并且仅在与 Copilot Studio 集成时用于原型设计或示例场景。此组件不是任何官方微软产品的一部分，且不在生产环境中可用。

以上所有内容完整地翻译成中文，只返回翻译后的内容，不包含其他无关信息。