Skip to main content

dcert-mcp

CI/CD Pipeline PyPI version License: MIT

The dcert MCP server for TLS certificate analysis. The server is a prebuilt Rust executable (dcert-mcp), installed as a wheel script, so starting it runs no Python. The optional proxy extra adds a FastMCP proxy, typed async client and the dcert-mcp-proxy command. Tools added to the Rust server are discovered at runtime, so the Python layer never needs to change.

This package is separate from dcert, the command line tool. Installing dcert-mcp pulls in dcert at the same version and nothing else.

Installation

Command Result Third party Python packages
pip install dcert-mcp the dcert-mcp MCP server, and dcert through the dependency 0
pip install "dcert-mcp[proxy]" plus the FastMCP proxy, typed client and dcert-mcp-proxy the FastMCP stack
pip install "dcert-mcp[proxy,otel]" plus OpenTelemetry export the FastMCP stack and OpenTelemetry

Requires Python 3.12 or later. Wheels exist for Linux x86_64 (glibc 2.34 or later: RHEL 9, Ubuntu 22.04, Debian 12 and later), macOS Intel, macOS Apple Silicon and Windows x86_64. Only these platform wheels are published, so an install from PyPI, a private mirror or a downloaded wheel never fetches anything from GitHub. On any other platform pip reports "no matching distribution"; build the binaries from source and point DCERT_MCP_BINARY at the server.

Without the extra, the Rust server works on its own (dcert-mcp speaks MCP over stdio, or HTTP with --mode http). The Python helpers below need the extra: importing one without it fails with a single line naming it, for example dcert_mcp needs the optional package 'fastmcp'. Install it with: pip install "dcert-mcp[proxy]".

Quick start

As a server

from dcert_mcp import create_server

create_server().run()  # stdio transport

As a client

import asyncio
from dcert_mcp import create_client

async def main() -> None:
    async with create_client() as client:
        tools = await client.list_tools()
        result = await client.call_tool("analyze_certificate", {"target": "example.com"})
        print(len(tools), result)

asyncio.run(main())

Typed async tool functions

The functional API opens a session (a subprocess plus its resilience stack) and passes it to plain async functions:

import asyncio
from dcert_mcp import analyze_certificate, check_expiry, create_session, export_pem

async def main() -> None:
    async with create_session(timeout=60.0) as session:
        cert = await analyze_certificate(target="example.com", session=session)
        expiry = await check_expiry(target="example.com", days=90, session=session)
        pem = await export_pem(target="example.com", output_path="chain.pem", session=session)
        raw = await session.call("tls_connection_info", {"target": "example.com"})

asyncio.run(main())

Leaving out session uses a shared default session that is created on first use and reused afterwards; close_default_session() shuts it down. The shared session belongs to the event loop that created it: a later asyncio.run() gets a fresh one, and calling close_default_session() before a loop ends releases the subprocess cleanly.

Function Description
analyze_certificate() Decode and analyse TLS certificates
check_expiry() Check certificate expiry within N days
check_revocation() Check OCSP revocation status
compare_certificates() Compare certificates between two targets
tls_connection_info() TLS connection details (cipher, protocol, latency)
export_pem() Export the certificate chain as PEM
verify_key_match() Verify a private key matches a certificate
convert_pfx_to_pem() Convert PKCS12/PFX to PEM files
convert_pem_to_pfx() Convert PEM cert and key to PKCS12/PFX
create_keystore() Create a PKCS12 keystore (Java compatible)
create_truststore() Create a PKCS12 truststore from CA certs
tls_scan() Enumerate the TLS versions, cipher suites and groups a server accepts
list_cipher_suites() List TLS cipher suites from the IANA registry (offline)
list_tls_policies() List the catalogued TLS security policies (offline)
show_tls_policy() Show one catalogued TLS security policy (offline)
tls_policy_test() Test an endpoint against a TLS security policy, or identify the closest one
explain_cipher_suite() Explain one cipher suite in any notation (offline)

The network facing functions accept the shared mTLS and connection options (client_cert, client_key, pkcs12, cert_password, ca_cert, connect_to, resolve, proxy, noproxy) as keyword arguments.

Error handling

from dcert_mcp import (
    DcertError,            # base class
    DcertTimeoutError,     # the call exceeded its timeout
    DcertConnectionError,  # the subprocess died or the circuit breaker is open
    DcertToolError,        # the tool returned an error result (has .tool)
)

Only transport failures are retried, with exponential backoff and full jitter, and only for tools whose MCP annotations mark them read-only or idempotent (the typed client reads the backend's tool list once per session to decide). TypeError and ValueError surface immediately and cancellation is never swallowed. A call that times out closes the subprocess (it is reconnected on the next call) and counts against the circuit breaker; concurrent calls that fail together share one reconnect and count as one failure.

Command line

dcert-mcp-proxy                                   # stdio (for MCP clients such as Claude Code)
dcert-mcp-proxy --transport http --port 8080      # HTTP; needs DCERT_MCP_AUTH_TOKEN or OIDC
dcert-mcp-proxy --binary /usr/local/bin/dcert-mcp # explicit binary
dcert-mcp-proxy --rate-limit 20 --bulkhead-max 4  # resilience flags
dcert-mcp-proxy --help                            # every option

HTTP and SSE mode refuse to start without authentication: a static bearer token of at least 32 characters (--auth-token or, better, DCERT_MCP_AUTH_TOKEN, compared in constant time) or an OIDC configuration (--oidc-issuer, --oidc-audience, --oidc-jwks-uri or DCERT_MCP_OIDC_ISSUER, DCERT_MCP_OIDC_AUDIENCE, DCERT_MCP_OIDC_JWKS_URL, all https). Requests whose Host header is not a loopback name, the bind address or an entry from --allowed-hosts are answered 400, which defeats DNS rebinding from a browser.

The proxy forwards only the environment variables listed under subprocess.passthrough_env in config.yaml to dcert-mcp: proxy and CA settings, TMPDIR, XDG_CACHE_HOME, DCERT_PROXY, DCERT_NOPROXY, DCERT_KB_FILE, every DCERT_MCP_* policy variable and the VAULT_ADDR, VAULT_TOKEN, VAULT_CACERT, VAULT_CAPATH and VAULT_SKIP_VERIFY settings. An entry ending in * matches by prefix.

dcert-mcp and dcert are the Rust executables themselves, so no Python wrapper sits in front of them.

Configuration

Defaults live in the packaged dcert_mcp/config.yaml: the environment variables forwarded to the subprocess, the server bind address, the transports and exporters offered by dcert-mcp-proxy, and every resilience value. dcert_mcp.load_config() returns them as an immutable record.

Resilience values can be overridden with DCERT_MCP_* environment variables (listed in dcert_mcp/resilience.py) and the dcert-mcp-proxy flags override those. A value outside its valid range (for example DCERT_MCP_CB_THRESHOLD=0 or DCERT_MCP_BULKHEAD_MAX=0) is rejected with a message naming the variable rather than crashing or hanging later. DCERT_MCP_NO_RETRY disables retries in both the proxy and the typed client, and DCERT_MCP_CONNECT_TIMEOUT bounds how long starting the subprocess and reading its tool list may take.

The proxy reads each tool's MCP annotations before applying caching or retries:

  • Caching (--cache) replays results only for tools marked read-only and idempotent. Tools that generate keys, issue or sign certificates, or change Vault state (create_csr, vault_issue, vault_sign, vault_renew, …) are always run.
  • Retry after a transport failure applies only to read-only or idempotent tools. Any other call surfaces the error instead of running a second time, because the first attempt may already have issued a certificate.

Binary discovery

  1. DCERT_MCP_BINARY; a relative path is resolved against the working directory, never through PATH
  2. A compiled dcert-mcp on PATH. The wheel installs it there; pip console script wrappers and the running launcher are skipped.

Nothing is downloaded at run time.

Environment variables forwarded to the binary

Category Variables
Proxy HTTP_PROXY, HTTPS_PROXY, NO_PROXY (and lowercase variants)
TLS SSL_CERT_FILE, SSL_CERT_DIR, REQUESTS_CA_BUNDLE
dcert DCERT_PATH, DCERT_MCP_TIMEOUT, DCERT_MCP_CONNECTION_TIMEOUT, DCERT_MCP_READ_TIMEOUT

Development

cd python/dcert-mcp
pip install -e ".[proxy,otel,dev]" --no-deps  # then install the extras' requirements
ruff check src tests ../../scripts
ruff format --check src tests ../../scripts
mypy
pytest

License

MIT

Metadata

Release files for dcert-mcp 4.0.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for dcert-mcp 4.0.5
File Actions
dcert_mcp-4.0.5-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for dcert_mcp-4.0.5-py3-none-win_amd64.whl
dcert_mcp-4.0.5-py3-none-manylinux_2_34_x86_64.whl Python 3 none Linux glibc 2.34+ x86-64 Details for dcert_mcp-4.0.5-py3-none-manylinux_2_34_x86_64.whl
dcert_mcp-4.0.5-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for dcert_mcp-4.0.5-py3-none-macosx_11_0_arm64.whl
dcert_mcp-4.0.5-py3-none-macosx_10_15_x86_64.whl Python 3 none macOS 10.15+ x86-64 Details for dcert_mcp-4.0.5-py3-none-macosx_10_15_x86_64.whl

Total release size: 26.0 MB

Release files / dcert_mcp-4.0.5-py3-none-win_amd64.whl

Download URL dcert_mcp-4.0.5-py3-none-win_amd64.whl
Size 7.4 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
d361549cd75765bb4600e728cc42e035b5c13178cb8ad9a8cc4caa0fb8f38077
BLAKE2b-256 checksum
How to use checksums
af6bb31bb4751302631f62d485145ef6029d808a34574724a332eca838ec0cd0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

Release files / dcert_mcp-4.0.5-py3-none-manylinux_2_34_x86_64.whl

Download URL dcert_mcp-4.0.5-py3-none-manylinux_2_34_x86_64.whl
Size 6.6 MB
Tags Linux glibc 2.34+ x86-64 Python 3
SHA-256 checksum
How to use checksums
073e270efb4de22e2a8fcb1a1eee2c9b5d077e514f247d49ec63bda57c0b5c30
BLAKE2b-256 checksum
How to use checksums
eae303d65c36b6c61d9a28acf592f5b3268ee4bcb0ed32960e7c130184c72b3b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

Release files / dcert_mcp-4.0.5-py3-none-macosx_11_0_arm64.whl

Download URL dcert_mcp-4.0.5-py3-none-macosx_11_0_arm64.whl
Size 5.9 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
78284afb623f866fd4b4a35e5219fb242be9d5a83efff971e3163e429a099268
BLAKE2b-256 checksum
How to use checksums
a08bb5567fedaa57515b9ed7af7b1b4005b24a2c42443a21ef98ab9c3ca4b75f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

Release files / dcert_mcp-4.0.5-py3-none-macosx_10_15_x86_64.whl

Download URL dcert_mcp-4.0.5-py3-none-macosx_10_15_x86_64.whl
Size 6.2 MB
Tags Python 3 macOS 10.15+ x86-64
SHA-256 checksum
How to use checksums
978c9b22f689620a02ea62f9fd2877219010227204d9c57f8471c03b09474d26
BLAKE2b-256 checksum
How to use checksums
f9232aa681698bef11d6554e34a56e1a7fa255dd640b249d7156838f65c4ab16
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

Security for dcert-mcp 4.0.5

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 4 files in this release have been uploaded with provenance metadata.

Select from 4 files

Attestation for dcert_mcp-4.0.5-py3-none-win_amd64.whl

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page