Calculator SSE

🚀 プロジェクトの概要

このプロジェクトは、カスタムMCPサーバーをCopilot Studioと統合する方法を示すサンプルです。このサーバーはMicrosoft Azure上にデプロイされ、デモ用に設計されています。このコンポーネントは、いかなる公式のMicrosoft製品の一部でもなく、本番環境での使用には適していません。

🔧 ローカル開発環境の実行方法

🚀 起動コマンド

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エンドポイントにアクセスする

• ブラウザで次のURLを開きます：http://localhost:3000/sse（ローカル）またはAzureにデプロイされたURL。
• 開発者ツールを開き、「ネットワーク」タブを選択します。
• EventStream 接続があることを確認します。
• Event タブで、以下の情報が表示されるはずです：
  • エンドポイント：SSEエンドポイント
  • データ：完全なURIエンドポイント

ステップ2：Postmanを使用してSSEエンドポイントをテストする

1. EventStreamの data から完全なURIをコピーします。
2. PostmanでこのURIにPOSTリクエストを送信します。

サンプル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サーバーであり、Microsoftの公式製品ではありません。
• デモ専用：Copilot Studioとの統合を目的として設計されており、デモやテストにのみ使用されます。
• 本番環境での使用不可：本番環境での使用には適していません。

⚠️ 重要な注意

これはサンプルのカスタムMCPサーバーであり、デモ目的のみで使用されます。Microsoft Azureにデプロイされており、Copilot Studioとの統合時のプロトタイピングまたはサンプルシナリオでのみ使用されます。このコンポーネントはいかなる公式のMicrosoft製品の一部でもなく、本番環境では使用できません。