MCP Joke Server with Authentication

基本能力

产品定位

MCP Joke Server with Authentication 是一个娱乐性质的 MCP 服务器，专注于提供编程相关的笑话服务，并支持与 VS Code Copilot 的集成。

核心功能

1. 笑话讲述：通过 tell_joke 工具提供编程相关的笑话，每次调用返回不同的笑话。
2. 身份验证：实现基于令牌的身份验证，保护 SSE 端点（/sse）的访问。
3. FastAPI 服务器：基于 FastAPI 构建的 HTTP 服务器，支持 MCP 协议。
4. VS Code Copilot 集成：可作为自定义代理与 VS Code Copilot 集成，提供笑话服务。

适用场景

1. 娱乐场景：为开发者提供轻松愉快的编程笑话。
2. 开发工具集成：与 VS Code Copilot 集成，增强开发体验。
3. MCP 协议学习：作为 MCP 服务器的示例，帮助开发者理解 MCP 协议和身份验证的实现。

工具列表

• tell_joke：提供编程相关的笑话，每次调用返回不同的笑话。

常见问题解答

1. 如何访问 SSE 端点？
2. 需要在 HTTP 头中包含 Bearer 令牌，例如：Authorization: Bearer valid_token。
3. 如何与 VS Code Copilot 集成？
4. 启动服务器后，VS Code 的设置已配置为使用此服务器，服务器会通过 MCP 协议响应笑话请求。
5. 生产环境需要注意什么？
6. 使用适当的令牌验证、安全存储密钥、实现令牌颁发和管理、使用 HTTPS 并添加速率限制等安全措施。

使用教程

使用依赖

1. 在 VS Code 中打开项目文件夹。
2. 当提示时，点击 "Reopen in Container" 以使用 devcontainer 配置。
3. 容器将自动从 requirements.txt 安装所有依赖。

安装教程

1. 启动服务器： bash python server.py
2. 服务器将在 http://localhost:8000 启动。

调试方式

1. 使用 curl 测试 SSE 端点： bash curl http://localhost:8000/sse \ -H "Authorization: Bearer valid_token"
2. 确保返回的笑话数据流正常。
3. 检查 VS Code Copilot 集成：
4. 确保服务器运行后，VS Code Copilot 能够正常请求笑话。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。