MCP Server Auth Template

Name: MCP Server Auth Template
Author: brunovicco

作者：brunoviccoバージョン 0.7.0i★ –iパソコンで動く

レジストリ名io.github.brunovicco/mcp-server-auth-template

インストール

概要

作者による説明（英語の原文）

OAuth 2.1/OIDC resource-server reference for secure MCP authorization

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況i未計測★ –

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: パソコンで動く
トランスポート: Streamable HTTP
カテゴリ: その他
入力が必要なもの：MCP_SERVER_RESOURCE_SERVER_URL, MCP_SERVER_AUTH_PROVIDER

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

基本チェック：1項目中1項目に合格
あなたのパソコンで、あなたのユーザーと同じ権限（ファイル、ネットワーク、アプリ）で動きます。
自分で入力するもの： MCP_SERVER_RESOURCE_SERVER_URL, MCP_SERVER_AUTH_PROVIDER, MCP_SERVER_REQUIRED_SCOPES, MCP_SERVER_TRANSPORT_ALLOWED_HOSTS, MCP_SERVER_ENTRA_TENANT_ID, MCP_SERVER_ENTRA_AUDIENCE, MCP_SERVER_ENTRA_APPLICATION_ID_URI, MCP_SERVER_GENERIC_ISSUER_URL, MCP_SERVER_GENERIC_AUDIENCE, MCP_SERVER_GENERIC_JWKS_ALLOWED_ORIGINS

必要なもの

DockerDockerのインストール

どのアプリを使っていますか？

ClaudeClaude CodeCursorVS CodeChatGPT

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

{
  "mcpServers": {
    "auth-template": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_SERVER_RESOURCE_SERVER_URL",
        "-e",
        "MCP_SERVER_AUTH_PROVIDER",
        "-e",
        "MCP_SERVER_REQUIRED_SCOPES",
        "-e",
        "MCP_SERVER_TRANSPORT_ALLOWED_HOSTS",
        "-e",
        "MCP_SERVER_ENTRA_TENANT_ID",
        "-e",
        "MCP_SERVER_ENTRA_AUDIENCE",
        "-e",
        "MCP_SERVER_ENTRA_APPLICATION_ID_URI",
        "-e",
        "MCP_SERVER_GENERIC_ISSUER_URL",
        "-e",
        "MCP_SERVER_GENERIC_AUDIENCE",
        "-e",
        "MCP_SERVER_GENERIC_JWKS_ALLOWED_ORIGINS",
        "ghcr.io/brunovicco/mcp-server-auth-template:v0.7.0"
      ],
      "env": {
        "MCP_SERVER_RESOURCE_SERVER_URL": "your-value",
        "MCP_SERVER_AUTH_PROVIDER": "your-value",
        "MCP_SERVER_REQUIRED_SCOPES": "your-value",
        "MCP_SERVER_TRANSPORT_ALLOWED_HOSTS": "your-value",
        "MCP_SERVER_ENTRA_TENANT_ID": "your-value",
        "MCP_SERVER_ENTRA_AUDIENCE": "your-value",
        "MCP_SERVER_ENTRA_APPLICATION_ID_URI": "your-value",
        "MCP_SERVER_GENERIC_ISSUER_URL": "your-value",
        "MCP_SERVER_GENERIC_AUDIENCE": "your-value",
        "MCP_SERVER_GENERIC_JWKS_ALLOWED_ORIGINS": "your-value"
      }
    }
  }
}

ターミナルでこれを実行します

claude mcp add auth-template --env MCP_SERVER_RESOURCE_SERVER_URL=your-value --env MCP_SERVER_AUTH_PROVIDER=your-value --env MCP_SERVER_REQUIRED_SCOPES=your-value --env MCP_SERVER_TRANSPORT_ALLOWED_HOSTS=your-value --env MCP_SERVER_ENTRA_TENANT_ID=your-value --env MCP_SERVER_ENTRA_AUDIENCE=your-value --env MCP_SERVER_ENTRA_APPLICATION_ID_URI=your-value --env MCP_SERVER_GENERIC_ISSUER_URL=your-value --env MCP_SERVER_GENERIC_AUDIENCE=your-value --env MCP_SERVER_GENERIC_JWKS_ALLOWED_ORIGINS=your-value -- docker run -i --rm -e MCP_SERVER_RESOURCE_SERVER_URL -e MCP_SERVER_AUTH_PROVIDER -e MCP_SERVER_REQUIRED_SCOPES -e MCP_SERVER_TRANSPORT_ALLOWED_HOSTS -e MCP_SERVER_ENTRA_TENANT_ID -e MCP_SERVER_ENTRA_AUDIENCE -e MCP_SERVER_ENTRA_APPLICATION_ID_URI -e MCP_SERVER_GENERIC_ISSUER_URL -e MCP_SERVER_GENERIC_AUDIENCE -e MCP_SERVER_GENERIC_JWKS_ALLOWED_ORIGINS ghcr.io/brunovicco/mcp-server-auth-template:v0.7.0

動かす前に、空欄の値を入力してください。

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

{
  "mcpServers": {
    "auth-template": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_SERVER_RESOURCE_SERVER_URL",
        "-e",
        "MCP_SERVER_AUTH_PROVIDER",
        "-e",
        "MCP_SERVER_REQUIRED_SCOPES",
        "-e",
        "MCP_SERVER_TRANSPORT_ALLOWED_HOSTS",
        "-e",
        "MCP_SERVER_ENTRA_TENANT_ID",
        "-e",
        "MCP_SERVER_ENTRA_AUDIENCE",
        "-e",
        "MCP_SERVER_ENTRA_APPLICATION_ID_URI",
        "-e",
        "MCP_SERVER_GENERIC_ISSUER_URL",
        "-e",
        "MCP_SERVER_GENERIC_AUDIENCE",
        "-e",
        "MCP_SERVER_GENERIC_JWKS_ALLOWED_ORIGINS",
        "ghcr.io/brunovicco/mcp-server-auth-template:v0.7.0"
      ],
      "env": {
        "MCP_SERVER_RESOURCE_SERVER_URL": "your-value",
        "MCP_SERVER_AUTH_PROVIDER": "your-value",
        "MCP_SERVER_REQUIRED_SCOPES": "your-value",
        "MCP_SERVER_TRANSPORT_ALLOWED_HOSTS": "your-value",
        "MCP_SERVER_ENTRA_TENANT_ID": "your-value",
        "MCP_SERVER_ENTRA_AUDIENCE": "your-value",
        "MCP_SERVER_ENTRA_APPLICATION_ID_URI": "your-value",
        "MCP_SERVER_GENERIC_ISSUER_URL": "your-value",
        "MCP_SERVER_GENERIC_AUDIENCE": "your-value",
        "MCP_SERVER_GENERIC_JWKS_ALLOWED_ORIGINS": "your-value"
      }
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "auth-template": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_SERVER_RESOURCE_SERVER_URL",
        "-e",
        "MCP_SERVER_AUTH_PROVIDER",
        "-e",
        "MCP_SERVER_REQUIRED_SCOPES",
        "-e",
        "MCP_SERVER_TRANSPORT_ALLOWED_HOSTS",
        "-e",
        "MCP_SERVER_ENTRA_TENANT_ID",
        "-e",
        "MCP_SERVER_ENTRA_AUDIENCE",
        "-e",
        "MCP_SERVER_ENTRA_APPLICATION_ID_URI",
        "-e",
        "MCP_SERVER_GENERIC_ISSUER_URL",
        "-e",
        "MCP_SERVER_GENERIC_AUDIENCE",
        "-e",
        "MCP_SERVER_GENERIC_JWKS_ALLOWED_ORIGINS",
        "ghcr.io/brunovicco/mcp-server-auth-template:v0.7.0"
      ],
      "env": {
        "MCP_SERVER_RESOURCE_SERVER_URL": "your-value",
        "MCP_SERVER_AUTH_PROVIDER": "your-value",
        "MCP_SERVER_REQUIRED_SCOPES": "your-value",
        "MCP_SERVER_TRANSPORT_ALLOWED_HOSTS": "your-value",
        "MCP_SERVER_ENTRA_TENANT_ID": "your-value",
        "MCP_SERVER_ENTRA_AUDIENCE": "your-value",
        "MCP_SERVER_ENTRA_APPLICATION_ID_URI": "your-value",
        "MCP_SERVER_GENERIC_ISSUER_URL": "your-value",
        "MCP_SERVER_GENERIC_AUDIENCE": "your-value",
        "MCP_SERVER_GENERIC_JWKS_ALLOWED_ORIGINS": "your-value"
      }
    }
  }
}

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

自分で入力する値

MCP_SERVER_RESOURCE_SERVER_URL 必須 env
Protected-resource URL advertised by this deployment
MCP_SERVER_AUTH_PROVIDER 必須 env
Authorization-server adapter to use
MCP_SERVER_REQUIRED_SCOPES env
JSON array of baseline delegated OAuth scopes
MCP_SERVER_TRANSPORT_ALLOWED_HOSTS env
Additional exact Host values accepted by the local container transport
MCP_SERVER_ENTRA_TENANT_ID env
Required when MCP_SERVER_AUTH_PROVIDER=entra
MCP_SERVER_ENTRA_AUDIENCE env
Required when MCP_SERVER_AUTH_PROVIDER=entra
MCP_SERVER_ENTRA_APPLICATION_ID_URI env
Required when MCP_SERVER_AUTH_PROVIDER=entra
MCP_SERVER_GENERIC_ISSUER_URL env
Required when MCP_SERVER_AUTH_PROVIDER=generic
MCP_SERVER_GENERIC_AUDIENCE env
Required when MCP_SERVER_AUTH_PROVIDER=generic
MCP_SERVER_GENERIC_JWKS_ALLOWED_ORIGINS env
Optional JSON array of explicitly trusted cross-origin JWKS origins

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月7日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント brunovicco で確認済みです
… 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
– 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
– 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
… 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

その他のほかのサーバーとの比較i

このカテゴリのほかの32655件のうち0%よりスターが多い
このカテゴリのほかの32655件のうち47%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの32655件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

MCP Server Auth Templateは安全ですか？

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

入力が必要なもの：MCP_SERVER_RESOURCE_SERVER_URL, MCP_SERVER_AUTH_PROVIDER

パソコンで動きますか、それともクラウドですか？

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は–、最新バージョン（0.7.0）がレジストリに届いたのは先月です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにDockerも必要です。

代わりに使えるものは？

同じカテゴリには：Spec Driven Development, Remote Desktop Commander, SuperCollider

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

Spec Driven Development

作者：formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

パソコンで動く★ 440MIT14 か月前更新

インストール

Remote Desktop Commander

作者：desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

クラウドで動く★ 211一昨日更新

インストール

SuperCollider

作者：Tok

Make sound with SuperCollider: synths, drums, chords, melodies and soundscapes over OSC.

パソコンで動く今日更新

インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

mcp-server-auth-template

*Leia em português*

A production-oriented OAuth 2.1 resource-server reference for remote MCP: Microsoft Entra ID and

generic OIDC, exact token/resource validation, fail-closed authorization, progressive scope

challenges, stateless MCP 2026-07-28, and metadata-only OpenTelemetry evidence.

Use this repository when the hard part is not "how do I expose an MCP tool?" but how do I expose it without weakening identity, authorization, transport, and observability boundaries. The server pairs with mcp-client-auth-template for an executable end-to-end reference using synthetic identities and no production credentials.

What this repository proves

The paired executable path validates real resource-server behavior rather than configuration claims:

✅ RFC 9728 Protected Resource Metadata is published by the resource server
✅ RFC 8707 resource binding becomes an exact JWT audience boundary
✅ issuer, signature, expiry, algorithm/key compatibility and caller type fail closed
✅ delegated scopes and Entra application roles remain distinct authorization concepts
✅ 403 insufficient_scope is returned before dispatch for progressive authorization
✅ wrong-audience tokens are rejected with 401, with an explicit token-resource policy that does not depend on MCP SDK defaults
✅ tools/list is filtered per principal and carries only bounded private cache hints
✅ protected tools stay hidden from anonymous catalog discovery
✅ MCP 2026-07-28 stays stateless and does not mint Mcp-Session-Id
✅ generic OIDC and Microsoft Entra ID share one application boundary without provider leakage
✅ W3C trace context reaches the server while OAuth/MCP sensitive values stay out of telemetry
✅ release artifacts, container evidence, SBOMs and provenance are validated by executable gates

For a requirement-by-requirement view of the paired OAuth/MCP behavior, including explicit evidence gaps and discussion topics for the MCP Authorization Interest Group / Tool Scopes Working Group, see the Authorization Implementer Report.

Architecture

flowchart LR

Client["MCP client"] -->|"OAuth 2.1 / OIDC"| AS["Authorization server Entra ID or generic OIDC"] Client -->|"MCP 2026-07-28 resource-bound bearer"| Admission["Transport admission"] Admission --> AuthN["Token verification"] AuthN --> AuthZ["Tool authorization"] AuthZ --> Tools["MCP tools"] Server["This resource server"] --- Admission

Server -->|"OIDC discovery + cached JWKS"| AS Server -.->|"W3C trace context + OTLP"| Collector["OpenTelemetry Collector"] Collector --> Tempo["Tempo"] Tempo --> Grafana["Grafana"]

The authorization server owns login, consent, client registration and token issuance. This repository owns the protected resource: transport admission, metadata publication, access-token verification, request-scoped principal construction, tool authorization and dispatch.

For layer boundaries and the detailed authorization sequence, see Architecture.

5-minute verification

The companion client owns the executable cross-repository reference flow. With both repositories cloned as siblings, verify this server directly from source:

cd ../mcp-client-auth-template

./scripts/run_reference_demo.sh \ --server-root ../mcp-server-auth-template

The flow starts the real server from this checkout plus a deterministic local OIDC provider and proves CIMD-first Authorization Code + PKCE, authenticated whoami, bounded scope step-up, wrong-audience rejection and stateless MCP behavior.

For the observable published-image proof:

cd ../mcp-client-auth-template

./scripts/run_observability_demo.sh --keep

The observable flow verifies one distributed trace across client and server, positive Collector receipt, Tempo retrieval, Grafana provisioning and telemetry privacy assertions.

See Verification guide for the exact evidence boundary.

Visual proof

The terminal proof below is captured from the source-level paired reference flow:

The trace screenshots are captured from a successful observable run and focus on mcp-server-auth-template spans:

Authentication profiles

Profile	Intended use	Key behavior
Entra delegated	Interactive enterprise users	Validates `scp`, tenant/application identifiers, issuer, audience and subject
Entra application	Provider-specific app-only deployments	Requires explicit `idtyp=app`; keeps `roles` separate from delegated scopes
Generic OIDC delegated	Standards-based interactive clients	Validates issuer/audience/signature/expiry and OAuth scopes
Generic OIDC client credentials	Unattended services in the deterministic pair profile	Accepts pre-registered machine tokens and progressive OAuth scopes

Set MCP_SERVER_AUTH_PROVIDER=entra or generic to switch adapters. The example whoami tool returns the verified caller identity; health requires the additional mcp:tools:health scope and demonstrates a pre-dispatch 403 insufficient_scope challenge.

Quick start

Prerequisites: Python 3.13 or 3.14 and uv.

git clone https://github.com/brunovicco/mcp-server-auth-template.git

cd mcp-server-auth-template cp .env.example .env uv sync --frozen --all-groups uv run uvicorn mcp_server_auth_template.entrypoints.mcp_server:create_app --factory --reload

Configure either the Entra or generic-OIDC block in .env, then point an MCP client at http://localhost:8000/mcp.

Endpoint	Purpose	Authentication
`/mcp`	MCP Streamable HTTP	Bearer token
`/.well-known/oauth-protected-resource`	Authorization-server discovery metadata	Public
`/livez`	Process liveness	Public, minimal response
`/readyz`	MCP lifespan readiness	Public, minimal response

For production-style execution:

uv run python -m mcp_server_auth_template.entrypoints.serve

See Production operations before exposing the service outside loopback.

Official MCP Registry

The server is published in the Official MCP Registry as:

io.github.brunovicco/mcp-server-auth-template@0.7.0

server.json describes the public GHCR image as an OCI package using the real streamable-http transport; it does not claim a hosted remotes endpoint. Publication is gated by the secure release pipeline and a dedicated Registry workflow that validates the immutable image, ownership metadata, and persisted Registry responses before publication.

See Official MCP Registry and the Authorization Implementer Report.

Security properties

The implementation is deliberately fail closed:

exact issuer and audience validation, bounded clock checks, algorithm/key compatibility and cached JWKS refresh;
an explicit validate_token_resource=False policy: provider audiences (Entra API client ID, api:// identifiers) are enforced by the token verifier, never by SDK URL string equality (ADR-0027);
principal-dependent discovery results are never shareable across authorization contexts (ADR-0028);
hardened discovery/JWKS egress against unsafe schemes, redirects, compression, oversized bodies, private/reserved destinations, mixed DNS answers and DNS rebinding;
Host, Origin, header, envelope, body-size and concurrency admission before authentication and tool dispatch;
delegated and application identities remain distinct; extension negotiation never grants authorization by itself;
bearer tokens and decoded claims remain request-local and are never logged or persisted;
tracing excludes credentials, arbitrary headers and URLs, MCP arguments/results, bodies, baggage and exception text.

This is a transparent reference implementation, not a security certification. Read Privacy and data handling and the architecture decisions under docs/adr/ before adapting the boundary.

MCP `2026-07-28`

Baseline: MCP specification 2026-07-28 and MCP Python SDK >=2.2,<3.

The paired templates exercise the modern stateless profile as executable behavior:

server/discover and per-request _meta carry protocol version, client identity and capabilities without the legacy initialize / initialized handshake;
modern requests use MCP-Protocol-Version, Mcp-Method and Mcp-Name;
responses do not mint Mcp-Session-Id;
Protected Resource Metadata drives authorization-server discovery;
RFC 8707 resource binds the access token audience exactly;
server/discover and tools/list carry SEP-2549 cache hints (ttlMs=30000, cacheScope=private);
runtime 403 insufficient_scope preserves prior grants and permits only one bounded replay of the undispatched operation;
machine-to-machine access is opt-in through io.modelcontextprotocol/oauth-client-credentials.

See Compatibility and the companion client's cross-repository E2E evidence.

Observability

a2a-otel-kit continues W3C trace context at the MCP ASGI boundary. Export remains network-silent unless A2A_OTEL_ENABLED=true and a complete OTLP traces endpoint are configured. Spans are metadata-only and sit inside hardened HTTP admission but outside authentication and tool dispatch.

See LLM and application observability.

Engineering evidence

deterministic quality gate covering lint, format, strict Mypy, architecture, tests/coverage, Bandit, dependency audit, supply-chain controls, governance and vendored contract validation;
SHA-pinned GitHub Actions with read-only permissions by default and isolated release authorities;
CycloneDX source/runtime inventories, complete vulnerability evidence and fail-closed exception policy;
allowlisted byte-reproducible Python release artifacts with SHA-256 manifests and GitHub build provenance;
policy-approved GHCR publication with immutable digest, provenance and SBOM attestations;
Python 3.13/3.14 against MCP SDK 2.2.0 and latest compatible 2.x, with MCP SDK deprecation warnings promoted to test failures so MCP 3 breakage surfaces early;
offline JWT fixtures using local keys and synthetic identities;
ADRs documenting security, protocol, operations, compatibility, observability and supply-chain decisions.

Demo vs production

Reference evidence	Production adoption
Synthetic local OIDC in companion demo	Enterprise authorization server with reviewed registration and consent

| Loopback/local reference networking | TLS-protected servic

冒頭だけを表示しています。続きはリポジトリで読めます

MCP Server Auth Template

概要

PopNx MCPの3つの柱

できること

インストール

インストールの前に

自分で入力する値

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

その他のほかのサーバーとの比較i

よくある質問

代わりの候補

Spec Driven Development

Remote Desktop Commander

SuperCollider

作者のREADME

mcp-server-auth-template

What this repository proves

Architecture

5-minute verification

Visual proof

Authentication profiles

Quick start

Official MCP Registry

Security properties

MCP 2026-07-28

Observability

Engineering evidence

Demo vs production

MCP `2026-07-28`