Skip to content
Back to search

mcp-login-proxy

OAuth login front for MCP servers: one config file per deployment, users sign in on a form, requests pass through unchanged

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 20 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Marceltov/mcp-login-proxy with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Marceltov/mcp-login-proxy'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/marceltov--mcp-login-proxy/badge.svg)](/listings/marceltov--mcp-login-proxy)

HTML

<a href="/listings/marceltov--mcp-login-proxy"><img src="/api/listings/marceltov--mcp-login-proxy/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 65 lines
  1. # mcp-login-proxy
  2. <p>
  3. <a href="https://mcp-login-proxy.marceltov.de/">
  4. <img alt="Documentation" src="https://img.shields.io/badge/docs-mcp--login--proxy.marceltov.de-2f7a27">
  5. </a>
  6. <a href="https://github.com/Marceltov/mcp-login-proxy/pkgs/container/mcp-login-proxy">
  7. <img alt="GHCR image" src="https://img.shields.io/github/v/release/Marceltov/mcp-login-proxy?logo=docker&logoColor=white&label=ghcr.io%2Fmarceltov%2Fmcp-login-proxy&color=2496ED">
  8. </a>
  9. <a href="LICENSE">
  10. <img alt="License: AGPL v3" src="https://img.shields.io/badge/License-AGPL_v3-blue.svg">
  11. </a>
  12. </p>
  13. An OAuth login front for MCP servers. Add its URL to claude.ai, the Claude apps, Claude Code or any other MCP client, sign in once on a form, and every request goes to the MCP server behind it unchanged. Everything about that server is one config file:
  14. - **How a login is checked:** against a fixed list of users and argon2id hashes (`users`, for a server with no login of its own), with one request to the server (`upstream`, for one that takes a credential per request), at a login URL whose answer holds a token (`exchange`, for one that hands out tokens), or at an OpenID Connect provider such as Authentik (`oidc`, with allowed groups or users).
  15. - **What is added to each request:** headers rendered from that login, e.g. `Authorization: Basic {basic}`. The client's own `Authorization` is never forwarded.
  16. - **House rules:** `instructions` are added to the server's `initialize` answer.
  17. Example configs: [Trilium Notes](docs/examples/trilium.yaml), [OpenCloud](docs/examples/opencloud.yaml), [OpenBB](docs/examples/openbb.yaml), [Authentik](docs/examples/authentik.yaml). The login comes from [mcp-login-oauth](https://github.com/Marceltov/mcp-login-oauth). This project was trilium-mcp-proxy until v0.2.0 ([ADR 0003](docs/adr/0003-a-general-login-front-configured-per-deployment.md)).
  18. ## Documentation
  19. **Full documentation: [mcp-login-proxy.marceltov.de](https://mcp-login-proxy.marceltov.de/)**
  20. - [Quick start](https://mcp-login-proxy.marceltov.de/getting-started/): write the config file, add the proxy, publish it over HTTPS
  21. - [Configuration](https://mcp-login-proxy.marceltov.de/configuration/): every key, and moving from trilium-mcp-proxy
  22. - [Connect a client](https://mcp-login-proxy.marceltov.de/connecting/), [security](https://mcp-login-proxy.marceltov.de/security/) and [how it works](https://mcp-login-proxy.marceltov.de/how-it-works/)
  23. ## Run it
  24. ```yaml
  25. services:
  26. mcp-proxy:
  27. image: ghcr.io/marceltov/mcp-login-proxy:0.2.0
  28. restart: unless-stopped
  29. environment:
  30. MCP_BASE_URL: https://mcp.example.org # the public URL, behind your TLS proxy
  31. MCP_OAUTH_SECRET: ${MCP_OAUTH_SECRET} # openssl rand -hex 32
  32. volumes:
  33. - ./proxy.yaml:/config/proxy.yaml:ro
  34. - mcp-proxy-oauth:/data
  35. ports:
  36. - "8081:8081"
  37. volumes:
  38. mcp-proxy-oauth:
  39. ```
  40. `docker run --rm -it ghcr.io/marceltov/mcp-login-proxy hash` makes a password hash for `login.users`.
  41. ## Development
  42. ```bash
  43. uv sync
  44. uv run pytest -q --ignore=tests/live # unit tests, against fake upstreams
  45. ./run-tests.sh -q # unit + live, against a disposable Trilium (Docker), with the Trilium example config
  46. ```
  47. ## License
  48. Copyright © 2026 Marcel Bruckner.
  49. Licensed under the [GNU Affero General Public License v3.0 or later](LICENSE) (AGPL-3.0-or-later). You may use, modify, and redistribute it, but any modified version — **including one you run as a network service** — must be released under the same license with its source made available to its users, and the original copyright notice preserved. See [LICENSE](LICENSE) for the full terms.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.