带有身份验证的 MCP 笑话服务器

这是一个模型上下文协议 (MCP) 服务器的示例实现，该服务器使用 FastAPI 提供带有基于令牌的身份验证的编程笑话。

设置

1. 在 VS Code 中打开此文件夹
2. 出现提示时，单击“在容器中重新打开”以使用 devcontainer 配置
3. 容器将自动安装 requirements.txt 中的所有依赖项

运行服务器

python server.py

服务器将在 http://localhost:8000 上启动

服务器功能

此 MCP 服务器提供简单的讲笑话功能。 每次调用时，它都会循环浏览一系列与编程相关的笑话。 服务器：

1. 实现一个名为 tell_joke 的 MCP 工具
2. 每次调用时返回不同的编程笑话
3. 需要身份验证才能访问 SSE 端点

身份验证

服务器为 SSE 端点 (/sse) 实现了简单的基于令牌的身份验证。 要发出请求，您需要在 HTTP 标头中包含 Bearer 令牌。

对于此演示，请使用令牌：valid_token

示例 curl 请求：

curl http://localhost:8000/sse \
  -H "Authorization: Bearer valid_token"

任何没有有效令牌的 SSE 端点请求都将收到 401 Unauthorized 响应。

VS Code Copilot 集成

此服务器可以用作 VS Code 中 GitHub Copilot 的自定义讲笑话代理。 要使用它：

1. 使用 python server.py 启动 MCP 服务器
2. VS Code 设置已在 .vscode/settings.json 中配置为使用此服务器
3. 服务器将通过 MCP 协议响应笑话请求

支持的功能

• 通过 MCP 工具讲笑话
• 用于 SSE 端点的基于令牌的身份验证
• 基于 FastAPI 的 HTTP 服务器

安全提示

这是一个演示实现。 在生产环境中，您应该：

1. 使用正确的令牌验证
2. 安全地存储密钥
3. 实施正确的令牌颁发和管理
4. 使用 HTTPS
5. 添加速率限制和其他安全措施