Ozzynet MCP Server

🚀 シンプルなMCPサーバー、ローカルRESTエンドポイントを通じた上位認証

このプロトタイプでは、MCPサーバーがツールを提供しますが、内部状態に基づいてアクセスを制限し、ユーザーに外部URLを通じた認証を要求します。

この場合、外部URLはQuarkus OIDCでラップされており、GitHubを通じた認証が必要です。

GitHubから取得したアクセストークンは、MCP内にユーザーのセッションIDと関連付けて保存されます。

⚠️ 重要提示

application.propertiesを編集して、GitHub OAuthアプリのクライアントIDとシークレットを追加する必要があります。

🚀 クイックスタート

このMCPサーバーを使用するには、以下の手順に従ってください。

✨ 主な機能

• MCPサーバーが提供するツールへのアクセスを内部状態に基づいて制限します。
• ユーザーに外部URL（GitHubを通じた認証）を通じた認証を要求します。
• GitHubから取得したアクセストークンをセッションIDと関連付けて保存します。

📦 インストール

必要条件

• JBang
• GitHubのOAuth2アプリ
• MCPクライアント（claudeなど）

GitHubのOAuth2アプリの作成

1. https://github.com/settings/developers にアクセスします。
2. 左側のメニューから「OAuth Apps」を選択します。
3. 「New OAuth App」をクリックします。
4. 名前を付け、コールバックURLを http://127.0.0.1:8080/auth に設定します。
5. クライアントIDをapplication.propertiesにコピーします。
6. 「Generate a new client secret」をクリックし、シークレットをapplication.propertiesにコピーします。

claudeの設定更新

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リポジトリの問題をリストアップします。

ClaudeはgetSessionIdツールを呼び出すための権限を要求します。 ClaudeはlistIssuesツールを呼び出し、認証が必要なため使用できないことを報告し、 http://127.0.0.1/auth?sessionId=<UUID> の形式のリンクを提供します。このリンクをクリックすると、 以前に作成したOAuthAppを通じてGitHubにリダイレクトされて認証を行います。認証が完了したら、Claudeに戻ってリスト操作を再試行できます。