Ozzynet MCP Server

🚀 簡單的 MCP 服務器，通過本地 REST 端點進行上游身份驗證

本項目是一個原型，其中 MCP 服務器提供工具，但會根據內部狀態限制對這些工具的訪問權限，同時要求用戶通過外部 URL 進行身份驗證。在當前場景下，外部 URL 使用 Quarkus OIDC 包裝，需通過 GitHub 完成身份驗證。GitHub 返回的訪問令牌會存儲在 MCP 中，與用戶使用的會話 ID 關聯。

⚠️ 重要提示

您必須編輯 application.properties 文件，添加您的 GitHub OAuth 應用的客戶端 ID 和客戶端密鑰。

🚀 快速開始

✨ 主要特性

• 提供 MCP 服務器工具。
• 根據內部狀態限制工具訪問權限。
• 通過外部 URL（基於 Quarkus OIDC 包裝）實現 GitHub 身份驗證。
• 存儲 GitHub 訪問令牌與用戶會話 ID 關聯。

📦 安裝指南

環境要求

• JBang
• 具有 GitHub 的 OAuth2 應用
• MCP 客戶端，如 claude

創建具有 GitHub 的 OAuth2 應用

1. 導航到 https://github.com/settings/developers。
2. 從左側菜單中選擇 “OAuth Apps”。
3. 點擊 “新建 OAuth App”。
4. 為應用命名，並將回調 URL 設置為 http://127.0.0.1:8080/auth。
5. 複製客戶端 ID 到 application.properties 文件。
6. 點擊 “生成新客戶端秘密”，並將生成的秘密複製到 application.properties 文件。

更新 claude 桌面配置 JSON

Windows 系統

{
    "mcpServers": {
        "ozzynet": {
            "command": "cmd",
            "args": [
                "/c",
                "C:\\Users\\YOURUSERNAME\\.jbang\\bin\\jbang.cmd",
                "--quiet",
                "org.ozzy:stiletto:1.0.0-SNAPSHOT:runner" 
            ]
        }
    }
}

Mac 系統

{
    "mcpServers": {
        "ozzynet": {
            "command": "jbang",
            "args": [
                "--quiet",
                "org.ozzy:stiletto:1.0.0-SNAPSHOT:runner" 
            ]
        }
    }
}

💻 使用示例

測試操作

讓 claude 列出倉庫的 issue，例如列出 quarkusio 的 quarkus 倉庫的問題：

1. Claude 會要求權限以調用 getSessionId 工具。
2. Claude 接著會調用 listIssues 工具，並提示無法使用該工具，因為需要進行身份驗證，同時會提供一個鏈接，格式為 http://127.0.0.1/auth?sessionId=<UUID>。
3. 點擊該鏈接，將會被重定向到 GitHub，通過之前創建的 OAuthApp 進行授權。
4. 授權完成後，返回 claude 並重新嘗試列出操作即可。