mcpserver.so LogoMCPFly
Submit
ozzynet-mcp-server logo

ozzynet-mcp-server

by BarDweller

AI/InfrastructureOAuth2GitHubAuthenticationQuarkusOIDCJBang

This is a prototype MCP server that limits tool access based on internal state, requiring user authentication via an external URL. It uses Quarkus OIDC to authenticate via GitHub and stores the GitHub access token for the user's session.

View on GitHub

Last updated: N/A

What is ozzynet-mcp-server?

A simple MCP server that offers tools but limits access based on internal state, requiring users to authenticate via an external URL. In this case, the external URL is wrapped with Quarkus OIDC, requiring authentication via GitHub.

How to use ozzynet-mcp-server?

  1. Create an OAuth2 App with GitHub, setting the callback URL to http://127.0.0.1:8080/auth. 2. Copy the client ID and secret to application.properties. 3. Update the Claude desktop config JSON with the appropriate command and arguments for your operating system. 4. Test by asking Claude to list issues for a repository. Follow the authentication link provided by Claude to authorize via GitHub.

Key features of ozzynet-mcp-server

  • Upstream authentication via local REST endpoint

  • GitHub OAuth2 integration

  • Session-based access token storage

  • Integration with MCP clients like Claude

  • External authentication flow

Use cases of ozzynet-mcp-server

  • Controlling access to MCP tools based on user authentication

  • Integrating GitHub authentication into MCP workflows

  • Providing a secure and authenticated environment for MCP operations

  • Prototyping MCP servers with external authentication requirements

FAQ from ozzynet-mcp-server

What is an MCP server?

An MCP server is a server that provides tools and services to MCP clients.

Why do I need to create an OAuth2 App with GitHub?

The OAuth2 App is required to authenticate users via GitHub and obtain an access token.

What is the callback URL for the OAuth2 App?

The callback URL should be set to http://127.0.0.1:8080/auth.

Where do I configure the client ID and secret for the OAuth2 App?

The client ID and secret should be configured in the application.properties file.

How do I test the MCP server?

You can test the MCP server by asking Claude to list issues for a repository. Claude will prompt you to authenticate via GitHub if you haven't already done so.