Simple MCP Server with upstream auth via local rest endpoint

@BarDweller

代码仓库

基本信息

分类

开发工具

传输方式

stdio

作者

BarDweller

关于 Simple MCP Server with upstream auth via local rest endpoint

A sandbox for MCP server prototyping

#mcp-server #oauth2 #prototyping

Simple MCP Server with upstream auth via local rest endpoint 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

Simple MCP Server with upstream auth via local rest endpoint 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Simple MCP Server with upstream auth via local rest endpoint?

This is a prototype MCP server that offers tools but limits their access based on internal state. Users must authenticate via an external URL that uses Quarkus OIDC with GitHub OAuth. The resulting access token is stored per session ID.

How to use Simple MCP Server with upstream auth via local rest endpoint?

Install JBang and create a GitHub OAuth App with the callback URL set to http://127.0.0.1:8080/auth. Copy the client ID and secret into application.properties. Then configure your MCP client (e.g., Claude Desktop) to run the JBang command jbang --quiet org.ozzy:stiletto:1.0.0-SNAPSHOT:runner. Authentication is initiated when a tool is used without a valid session.

Key features of Simple MCP Server with upstream auth via local rest endpoint

Requires authentication via GitHub OAuth before tool access
Stores access tokens per session ID for reuse
Integrates with standard MCP clients like Claude Desktop
Uses JBang for execution with a Maven artifact
Leverages Quarkus OIDC for the OAuth flow
Provides a local REST endpoint for callback (localhost:8080)

Use cases of Simple MCP Server with upstream auth via local rest endpoint

Authenticating before listing issues for a GitHub repository (e.g., quarkusio/quarkus)
Demonstrating OAuth-integrated tool access in an MCP client
Testing prototype workflows where tool usage requires external identity verification

常见问题

What dependencies are required to run this server?

You need JBang, a GitHub OAuth App, and an MCP client such as Claude Desktop.

How do I set up the GitHub OAuth App?

Navigate to GitHub Developer Settings, create a new OAuth App, set the callback URL to `http://127.0.0.1:8080/auth`, then copy the client ID and generate a client secret. Paste both into `application.properties`.

How does authentication work in practice?

When a tool is invoked without a valid session, the server returns a link like `http://127.0.0.1/auth?sessionId=<UUID>`. Clicking it redirects to GitHub for OAuth authorization. After successful authentication, you can retry the tool in Claude.

What tools are available in this server?

The README demonstrates two tools: `getSessionId` and `listIssues`. The `listIssues` tool requires authentication before use.

Is this server ready for production use?

No, it is explicitly described as a prototype.

开发工具分类下的更多 MCP 服务器

offprompt

MCP server that lets Claude Code, Cursor or Codex ask you for API keys on a local page and write them to .env. The agent only ever sees key names.

ArtiBot Cloud MCP - Zhijiangyun 智匠云

bofob

ArtiBot Cloud MCP (Zhijiangyun 智匠云) — cloud MCP server for robot manipulation data & GPU workloads. 15 tools: robot fleet management, data collection & video recording, post-processing pipelines, and benchmark evaluation

FARPY

mangomunchr

Verified distributed compute for humans, applications, and agents. Submit Blender, Octane, and video workloads, route them across qualified GPUs, track asynchronous execution, download finished artifacts, and verify FARP

Moxie Docs

Jackalope-Dev

Automated codebase documentation for GitHub: searchable docs, MCP context for AI agents, doc drift detection, and Friday Cleanup PRs.

OrangePro

Aamir Siddiqui

OrangePro local-first CLI + MCP server for behavior mapping, grounded test generation, and dynamic proof.