MCP Joke Server logo

MCP Joke Server

by flowsoft-org

A sample MCP server that serves programming jokes with token-based authentication using FastAPI. It can be integrated with VS Code Copilot as a custom joke-telling agent.

View on GitHub

Last updated: N/A

What is MCP Joke Server?

This is a sample implementation of a Model Context Protocol (MCP) server that provides programming jokes. It uses FastAPI to create an HTTP server with token-based authentication for accessing the SSE endpoint.

How to use MCP Joke Server?

  1. Clone the repository and open it in VS Code with the devcontainer. 2. Run the server using python server.py. 3. Access the SSE endpoint at http://localhost:8000/sse with the Bearer token valid_token in the Authorization header. 4. Configure VS Code Copilot to use this server as a custom agent.

Key features of MCP Joke Server

  • Joke telling via MCP tool

  • Token-based authentication for SSE endpoint

  • FastAPI-based HTTP server

  • Integration with VS Code Copilot

Use cases of MCP Joke Server

  • Custom joke-telling agent for VS Code Copilot

  • Demonstration of MCP server implementation

  • Example of token-based authentication with FastAPI

  • Educational resource for learning about MCP and FastAPI

FAQ from MCP Joke Server

What is MCP?

MCP stands for Model Context Protocol. It's a protocol for communication between applications.

What is FastAPI?

FastAPI is a modern, high-performance web framework for building APIs with Python.

How do I authenticate with the server?

Include a Bearer token in the Authorization header when making requests to the /sse endpoint. Use valid_token for this demo.

Where is the token validation implemented?

The token validation is implemented in the server.py file.

Is this server production-ready?

No, this is a demonstration implementation. See the Security Note in the README for important considerations for production environments.