MCP Authentication Samples

🚀 MCP 笑話服務器帶身份驗證

本項目是一個基於 FastAPI 實現的 Model Context Protocol (MCP) 服務器示例，它能提供帶有基於令牌身份驗證的編程笑話服務，為用戶帶來有趣的編程笑話體驗。

🚀 快速開始

環境搭建

1. 在 VS Code 中打開此文件夾。
2. 當收到提示時，點擊“重新在容器中打開”，以使用 devcontainer 配置。
3. 容器會自動從 requirements.txt 安裝所有依賴項。

服務器運行

執行以下命令啟動服務器：

python server.py

服務器將在 http://localhost:8000 啟動。

✨ 主要特性

• 講笑話功能：此 MCP 服務器具備簡單的講笑話能力，每次調用時，會在一個編程相關的笑話集合中循環切換。
• 單一 MCP 工具：實現了單一的 MCP 工具 tell_joke。
• 身份驗證：需要身份驗證才能訪問 SSE 端點，服務器為 SSE 端點 (/sse) 實現了簡單的基於令牌的身份驗證。
• VS Code Copilot 集成：可作為 GitHub Copilot 在 VS Code 中使用的自定義笑話代理。

📦 安裝指南

環境搭建

1. 在 VS Code 中打開此文件夾。
2. 當提示時，點擊“重新在容器中打開”以使用 devcontainer 配置。
3. 容器會自動從 requirements.txt 安裝所有依賴項。

💻 使用示例

服務器啟動

python server.py

服務器將在 http://localhost:8000 啟動。

身份驗證請求示例

服務器為 SSE 端點 (/sse) 實現了基於令牌的身份驗證。要進行請求，需在 HTTP 頭部中包含有效的 Bearer 令牌。

對於此演示，請使用以下令牌：valid_token

示例 curl 請求：

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

任何未提供有效令牌的 SSE 端點請求都將收到 401 Unauthorized 響應。

VS Code Copilot 集成使用

此服務器可作為 GitHub Copilot 在 VS Code 中使用的自定義笑話代理。使用步驟如下：

1. 使用 python server.py 啟動 MCP 服務器。
2. 已經在 .vscode/settings.json 中配置了 VS Code 設置以使用此服務器。
3. 服務器將通過 MCP 協議響應對笑話的請求。

📚 詳細文檔

服務器功能

此 MCP 服務器提供了一個簡單的講笑話能力。每次調用時，它會在一個編程相關的笑話集合中循環切換。服務器的功能包括：

1. 實現了單一的 MCP 工具 tell_joke。
2. 每次調用返回不同的編程笑話。
3. 需要身份驗證才能訪問 SSE 端點。

支持的功能

• 通過 MCP 工具講笑話。
• SSE 端點的基於令牌的身份驗證。
• 基於 FastAPI 的 HTTP 服務器。

🔧 技術細節

身份驗證

服務器為 SSE 端點 (/sse) 實現了一個簡單的基於令牌的身份驗證。要進行請求，您需要在 HTTP 頭部中包含有效的 Bearer 令牌。對於此演示，請使用令牌 valid_token。

安全注意事項

這是演示實現。在生產環境中，您應該：

1. 使用適當的身份驗證。
2. 安全存儲秘密。
3. 實現有效的令牌頒發和管理。
4. 使用 HTTPS。
5. 添加速率限制和其他安全措施。

⚠️ 重要提示

此項目為演示實現，在生產環境中需按照安全注意事項進行相應的安全配置。

💡 使用建議

在使用服務器時，確保在 HTTP 頭部中包含有效的 Bearer 令牌，以避免收到 401 Unauthorized 響應。