Advertise
MCP.so
Sign In

MCP Joke Server with Authentication

@flowsoft-org

Repository

Basic information

Category

Other

License

MIT license

Transports

stdio

Author

flowsoft-org

About MCP Joke Server with Authentication

Play around with mcp-servers and their mcp-client authentication options

MCP Joke Server with Authentication config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-authentication-samples": {
      "command": "python",
      "args": [
        "server.py"
      ]
    }
  }
}

MCP Joke Server with Authentication tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Joke Server with Authentication?

This is a sample implementation of a Model Context Protocol (MCP) server that serves programming jokes with token-based authentication using FastAPI. It is intended as a demonstration for integration with GitHub Copilot in VS Code.

How to use MCP Joke Server with Authentication?

Open the project folder in VS Code, click “Reopen in Container” to use the devcontainer, then run python server.py. The server starts on http://localhost:8000. Access the SSE endpoint at /sse with a Bearer token: use valid_token for this demo.

Key features of MCP Joke Server with Authentication

  • Single MCP tool called tell_joke
  • Returns a different programming joke on each invocation
  • Token-based authentication for the SSE endpoint
  • FastAPI-based HTTP server
  • Designed for VS Code Copilot integration

Use cases of MCP Joke Server with Authentication

  • Providing a custom joke-telling agent for GitHub Copilot in VS Code
  • Demonstrating MCP server setup with authentication
  • Learning how to build a simple MCP server with FastAPI

Frequently asked questions

1

What does the server do?

It cycles through a collection of programming-related jokes each time the `tell_joke` tool is called, returning one joke per invocation.

2

What dependencies or runtime are required?

The server runs inside a VS Code devcontainer that automatically installs dependencies from `requirements.txt`. Python and FastAPI are the primary requirements.

3

How is authentication handled?

The server uses a simple Bearer token for the SSE endpoint. A valid token (`valid_token`) must be included in the HTTP header. Requests without a valid token receive a 401 Unauthorized response.

4

Are there any known limits?

This is a demonstration implementation; it is not production-ready. For production, you should use proper token validation, secure secrets, HTTPS, and rate limiting.

5

Where does the joke data live?

Jokes are stored in‑memory as a collection, and the server cycles through them on each call. No external database is used.

Comments

More Other MCP servers

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

Glasswarp

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

Advertise