Mcsmcp

🚀 Detailed Explanation of Jokes MCP Server in Microsoft Copilot Studio

This project provides a detailed guide on setting up and using the Jokes MCP Server in Microsoft Copilot Studio. It allows users to interact with Copilot to get jokes from various sources.

🚀 Quick Start

This experiment will guide you through the following steps:

1. Set up the Jokes MCP Server in Microsoft Copilot Studio
2. Interact with Copilot to get jokes
3. Understand how the MCP server works in Copilot Studio

Through this experiment, you will be able to:

• Integrate and run the Jokes MCP Server in Copilot Studio
• Use different commands to get jokes from multiple sources (including Chuck Norris, dad, and yo mama jokes)

✨ Features

• Integrate and run the Jokes MCP Server in Copilot Studio.
• Use different commands to get jokes from multiple sources.
• Customize joke sources.
• Troubleshoot common issues and optimize performance.

📦 Installation

Experimental Environment

Basic Requirements

• Copilot Studio: Requires a Microsoft 365 or Visual Studio subscription.
• Jokes MCP Server: Built on the TypeScript SDK.

Recommended Tools

1. Node.js and npm: Used to run and build the server.
2. Git: Used for code version control.

💻 Usage Examples

Part 1: Set up the Jokes MCP Server in Copilot Studio

Step 1: Create a New Experiment

1. Open Microsoft Copilot Studio.
2. Click the "New Experiment" button and select a blank project.

Step 2: Integrate the Jokes MCP Server

1. Add a new module named jokes-mcp-server to the experiment.
2. Paste the following code into the module's editor:

// 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() {
    // Implement the logic to get a joke from chucknorris.io
}

async function getDadJoke() {
    // Implement the logic to get a joke from icanhazdadjoke.com
}

async function getYoMamaJoke() {
    // Implement the logic to get a joke from yomama-jokes.com
}

Step 3: Configure the MCP Proxy

1. In Copilot Studio, navigate to "Settings" > "Models and Proxies".
2. Add a new proxy and specify the jokes-mcp-server module.

Part 2: Test the Jokes MCP Server

Test Commands

Enter the following in the Copilot Studio chat interface:

1. Chuck Norris Joke

/get-chuck-joke

2. Dad Joke

/get-dad-joke

3. Yo Mama Joke

/get-yo-mama-joke

Expected Output

1. Example of a Chuck Norris joke:

"Why doesn't Chuck Norris need a GPS? Because he knows every direction is his name."

2. Example of a dad joke:

"Why is the math book always sad? Because it has too many problems!"

3. Example of a yo mama joke:

"Why is Yo Mama's party always quiet? Because she only invites herself and her shadow!"

Part 3: Advanced Features

Step 1: View Joke Sources

Enter the following command to get all available joke sources:

/sources

Step 2: Customize Joke Sources

1. Add a new joke source in jokes-mcp-server.ts.
2. Update the proxy configuration to support the new source.

Example: Add a "Cat-Dog" Joke Source

// jokes-mcp-server.ts
async function getCatDogJoke() {
    // Implement the logic to get a joke from catdog-jokes.com
}

Part 4: Troubleshooting and Optimization

Common Issues

1. Unable to get a joke
   • Check the network connection.
   • Ensure that the target joke website does not restrict access.
2. Error messages
   • Check the console logs for detailed error information.
   • Ensure that all API requests are correctly implemented.

Performance Optimization

1. Add error handling:

async function getChuckNorrisJoke() {
    try {
        // Logic to get the joke
    } catch (error) {
        console.error('Error getting Chuck Norris joke:', error);
        return 'Sorry, unable to get the current joke.';
    }
}

2. Implement a caching mechanism to improve performance:

let lastChuckJoke: string | null = null;

async function getChuckNorrisJoke() {
    if (lastChuckJoke) return lastChuckJoke;
    
    // Get a new joke and update lastChuckJoke
}

📚 Documentation

Tools and Resources

• Node.js and npm: Used to run and build the server.
• Git: Used for code version control.

Known Issues and Improvement Plans

1. Current Limitations
   • Currently, only three joke sources are supported.
   • The number of jokes is limited. It is recommended to update the content regularly.
2. Future Improvements
   • Add more joke sources (e.g., programmer, school, etc.).
   • Implement joke classification and filtering functions.

Contribution Guidelines

1. How to Contribute Code
   • Submit a pull request to the jokes-mcp-server repository.
   • Ensure that the code complies with TypeScript standards.
2. How to Report Issues
   • Create a new issue in the GitHub repository.
   • Provide detailed error information and reproduction steps.

Copyright Statement

• All content in this guide is subject to the Microsoft license agreement.
• The copyright of the notebook code and documentation belongs to the author. Please indicate the source when reprinting.

Trademark Information

• Microsoft, Copilot Studio, and related logos are registered trademarks of Microsoft Corporation.