convez.ai
MCP ServerDevOps & InfraestruturaAvançado
chris-dare

Pontifex MCP

chris-dare/pontifex

Governança e segurança enterprise para servidores MCP em produção

Ver no GitHub
InicialPluginScore · de 0 a 100

Camada 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/pontifex

1 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

Estrelas
2
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 2 meses
Versão
v0.5.1
Issues abertas
21
Contribuidores
3

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

License

Apache-2.0 © Chris Dare. Part of Argonauts.

Ver o original no GitHub

Bom para

Relacionados