q-ring MCP Server

io.github.I4cTime/q-ring

Repository Registry

What is the q-ring MCP server?

OS keychain secrets for AI coding agents, over MCP.

How to install q-ring

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

QRING_BACKEND
Secret storage backend. Defaults to the OS keychain; set to "file" for headless hosts with no Secret Service (CI, containers).
QRING_FILE_PASSPHRASE
secret
Passphrase for the encrypted file backend (AES-256-GCM). Required only when QRING_BACKEND=file — without it the file backend fails closed.
QRING_FILE_BACKEND_PATH
Custom path for the encrypted file store (default: ~/.config/q-ring/file-backend.enc).
QRING_CONFIG_DIR
Directory for q-ring's registries — hooks, entanglement, approvals, canary webhooks, agent memory (default: ~/.config/q-ring).

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "q-ring": {
      "command": "npx",
      "args": [
        "-y",
        "@i4ctime/q-ring"
      ],
      "env": {
        "QRING_BACKEND": "<YOUR_QRING_BACKEND>",
        "QRING_FILE_PASSPHRASE": "<YOUR_QRING_FILE_PASSPHRASE>",
        "QRING_FILE_BACKEND_PATH": "<YOUR_QRING_FILE_BACKEND_PATH>",
        "QRING_CONFIG_DIR": "<YOUR_QRING_CONFIG_DIR>"
      }
    }
  }
}