MCP Joke Server with Authentication

@flowsoft-org

代码仓库

基本信息

分类

其他

许可证

MIT license

传输方式

stdio

作者

flowsoft-org

关于 MCP Joke Server with Authentication

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

MCP Joke Server with Authentication 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

MCP Joke Server with Authentication 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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

常见问题

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.

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.

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.

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.

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.

其他分类下的更多 MCP 服务器

ICSS

chokcoco

不止于 CSS

20.7K

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct