Pontifex MCP
chris-dare/pontifex
Governança e segurança enterprise para servidores MCP em produção
Ver no GitHubCamada de segurança e governança para servidores MCP em produção. Adiciona autenticação (OAuth 2.1 / JWT / API keys), controle de escopo por chamador, rate limiting, auditoria completa e observabilidade a qualquer servidor MCP construído com o SDK oficial.
Instalação
npx convez-ai chris-dare/pontifex1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Expor APIs internas e data stores a agentes de IA com controle de acesso fino
- Implementar auditoria e compliance em chamadas de ferramentas MCP
- Construir servidores MCP multi-tenant com isolamento por caller
Veredito

Ferramenta madura e bem pensada para quem precisa levar MCP para produção com segurança real. A arquitetura de zero domain knowledge no core e plugins via domain folders é elegante; documentação sólida e exemplo funcional (GSE) facilitam adoção.
README
A tradução para o português deste README ainda está na fila.
Pontifex MCP
The security and governance layer for MCP servers, built on the official MCP Python SDK.
This is the home of pontifex-mcp — a Python library for building MCP servers that connect AI agents to real systems without giving up control over who can call what. You write the tools; it handles authentication, per-caller scopes, rate limits, and a full audit trail.
The idea
AI agents are ready to do real work against your systems. What the MCP SDK gives you is a server that exposes tools. What it doesn't give you is the control that makes a server safe to point at production data: who is calling, what they're allowed to touch, how often, and a record of what happened.
pontifex-mcp is that control layer. It turns your existing APIs, data stores, and internal services into governed tools any AI agent can call — and it runs on your own infrastructure, so your data never leaves your environment.
- Secure by default — OAuth 2.1 JWTs and
sk_…API keys; every tool call is authenticated, against any OIDC provider (Auth0, Entra, Clerk, Keycloak). - Least-privilege scopes —
domain:resource:action, checked before every call. Callers can't widen their own access. - Auditable — every call recorded: who, what, when, data source, cache hit, latency.
- Resilient — per-caller rate limiting, adapter failover, circuit breaking.
- Observable — Logfire / OpenTelemetry tracing and metrics wired in.
- Built on the MCP SDK — keep its tools, protocol, and transports; add the controls a production server needs.
Install
pip install pontifex-mcp # or: uv add pontifex-mcp
Requires Python 3.12+, Postgres, and Redis. The full quickstart — building your own domain, configuration, the security model — lives in core/README.md and the documentation.
This repository
A uv workspace holding the library and a demo domain:
core/pontifex_mcp/ The pontifex-mcp library — auth, scopes, audit, resilience, observability
domains/gse/ Ghana Stock Exchange — a worked example domain built on the library
alembic/ Database migrations (core schema + per-domain schemas)
tests/ core + domain tests
deploy/ Dockerfiles, fly.toml
scripts/ Operational scripts (seed, export audit, health check)
Core has zero domain knowledge. A domain is a self-contained folder under domains/ — a settings class, one or more data adapters, and tools wrapped with tool_runtime. Adding one requires no changes to core. The GSE domain is the reference: see domains/gse/README.md.
Develop
git clone https://github.com/chris-dare/pontifex && cd pontifex
docker compose up -d redis postgres # infrastructure
uv sync # install the workspace
uv run alembic upgrade head # run migrations
uv run pytest # tests
Lint with uv run ruff check ., format with uv run ruff format ., type-check with uv run ty check.
Documentation
- Docs site — https://chris-dare.github.io/pontifex/
- Package README — core/README.md (also rendered on PyPI)
- Demo domain — domains/gse/README.md
License
Apache-2.0 © Chris Dare. Part of Argonauts.