Mcsmcp

🚀 Microsoft Copilot Studio の Jokes MCP サーバー詳解

このプロジェクトは、Microsoft Copilot Studio で Jokes MCP サーバーをセットアップし、コピュロットとやり取りしてジョークを取得する方法を説明します。また、MCP サーバーが Copilot Studio 内でどのように機能するかを理解することができます。

🚀 クイックスタート

実験説明

実験目標

この実験では、以下の手順を完了する方法を学びます。

1. Microsoft Copilot Studio で Jokes MCP Server を設定する
2. Copilot とやり取りしてジョークを取得する
3. MCP サーバーが Copilot Studio 内でどのように機能するかを理解する

この実験を通じて、以下のことができるようになります。

• Copilot Studio で Jokes MCP Server を統合して実行する
• さまざまなコマンドを使用して、複数のソース（Chuck Norris、ダディジョーク、ママジョークなど）からジョークを取得する

実験環境

基礎要件

• Copilot Studio：Microsoft 365 または Visual Studio のサブスクリプションが必要です。
• Jokes MCP Server：TypeScript SDK をベースに構築されています。

推奨ツール

1. Node.js と npm：サーバーの実行と構築に使用します。
2. Git：コードのバージョン管理に使用します。

実験手順

第一部：Copilot Studio で Jokes MCP サーバーを設定する

手順 1：新しい実験を作成する

1. Microsoft Copilot Studio を開きます。
2. 「新しい実験」ボタンをクリックし、空白のプロジェクトを選択します。

手順 2：Jokes MCP Server を統合する

1. 実験に新しいモジュールを追加し、jokes-mcp-server と名付けます。
2. 以下のコードを該当モジュールのエディターに貼り付けます。

// jokes-mcp-server.ts
import { Agent } from '@modelcontextprotocol/typescript-sdk';

const agent = new Agent();

agent.on('input', async (input) => {
    if (input.toLowerCase().includes('chuck norris')) {
        return getChuckNorrisJoke();
    } else if (input.toLowerCase().includes('dad joke')) {
        return getDadJoke();
    } else if (input.toLowerCase().includes('yo mama')) {
        return getYoMamaJoke();
    }
});

async function getChuckNorrisJoke() {
    // 実装：chucknorris.io からジョークを取得するロジック
}

async function getDadJoke() {
    // 実装：icanhazdadjoke.com からジョークを取得するロジック
}

async function getYoMamaJoke() {
    // 実装：yomama-jokes.com からジョークを取得するロジック
}

手順 3：MCP エージェントを設定する

1. Copilot Studio で、「設定」>「モデルとエージェント」に移動します。
2. 新しいエージェントを追加し、jokes-mcp-server モジュールを指定します。

第二部：Jokes MCP サーバーをテストする

テストコマンド

Copilot Studio のチャット画面に以下の内容を入力します。

1. Chuck Norris ジョーク

/get-chuck-joke

2. ダディジョーク

/get-dad-joke

3. ママジョーク

/get-yo-mama-joke

期待される出力

1. Chuck Norris ジョークの例：

「なぜ Chuck Norris は GPS が必要ないのか？彼はすべての方向が彼の名前であることを知っているから。」

2. ダディジョークの例：

「なぜ数学の本はいつも悲しんでいるのか？問題が多すぎるから！」

3. ママジョークの例：

「なぜ Yo Mama のパーティーはいつも静かなのか？彼女は自分と自分の影だけを招待したから！」

第三部：高度な機能

手順 1：ジョークのソースを表示する

以下のコマンドを入力して、利用可能なすべてのジョークソースを取得します。

/sources

手順 2：ジョークのソースをカスタマイズする

1. jokes-mcp-server.ts に新しいジョークソースを追加します。
2. 新しいソースをサポートするようにエージェントの設定を更新します。

例：「猫と犬」のジョークソースを追加する

// jokes-mcp-server.ts
async function getCatDogJoke() {
    // 実装：catdog-jokes.com からジョークを取得するロジック
}

第四部：トラブルシューティングと最適化

一般的な問題

1. ジョークが取得できない場合
   • ネットワーク接続を確認します。
   • 対象のジョークサイトがアクセス制限されていないことを確認します。
2. エラーメッセージが表示される場合
   • コンソールログを確認して詳細なエラー情報を取得します。
   • すべての API リクエストが正しく実装されていることを確認します。

パフォーマンスの最適化

1. エラーハンドリングを追加する：

async function getChuckNorrisJoke() {
    try {
        // ジョークを取得するロジック
    } catch (error) {
        console.error('Chuck Norris ジョークを取得する際にエラーが発生しました：', error);
        return '申し訳ありません、現在のジョークを取得できません。';
    }
}

2. パフォーマンス向上のためにキャッシュ機構を実装する：

let lastChuckJoke: string | null = null;

async function getChuckNorrisJoke() {
    if (lastChuckJoke) return lastChuckJoke;
    
    // 新しいジョークを取得して lastChuckJoke を更新する
}

📚 ドキュメント

ツールとリソース

• Node.js と npm：サーバーの実行と構築に使用します。
• Git：コードのバージョン管理に使用します。

既知の問題と改善計画

1. 現在の制限事項
   • 現在は 3 つのジョークソースのみをサポートしています。
   • ジョークの数が限られているため、定期的にコンテンツを更新することをお勧めします。
2. 将来の改善点
   • より多くのジョークソース（プログラマー、学校など）を追加する。
   • ジョークの分類とフィルタリング機能を実装する。

コントリビューションガイド

1. コードのコントリビュート方法
   • jokes-mcp-server リポジトリにプルリクエストを送信します。
   • コードが TypeScript 標準に準拠していることを確認します。
2. 問題の報告方法
   • GitHub リポジトリに新しいイシューを作成します。
   • 詳細なエラー情報と再現手順を提供します。

著作権表示

• このガイドのすべての内容は、Microsoft のライセンス契約の対象となります。
• ノートブックのコードとドキュメントの著作権は著者に帰属し、転載する場合は出典を明記してください。

商標情報

• Microsoft、Copilot Studio および関連するロゴは、Microsoft Corporation の登録商標です。