q-ring MCP server
OS keychain secrets for AI coding agents, over MCP.
5 stars382 downloads/wk
Reviews
Write oneNobody has reviewed q-ring yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
q-ring tools (44, 4 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
agent_forgetagent_recallagent_rememberagent_scananalyze_secretsaudit_logcheck_policycheck_projectci_validate_secretsdelete_secretwrite actiondetect_anomaliesdetect_environmentdisentangle_secretsentangle_secretsenv_generateexec_with_secretsexport_auditexport_secretsgenerate_secretget_policy_summaryget_project_contextget_secrethas_secrethealth_checkimport_dotenvinspect_secretlint_fileslist_hookslist_providerslist_secretsregister_hookremove_hookwrite actionrotate_secretscan_codebase_for_secretsset_secretstatus_dashboardteleport_packteleport_unpacktunnel_createwrite actiontunnel_destroywrite actiontunnel_listtunnel_readvalidate_secretverify_audit_chain
Public scan report
scanner v0.1.9 · 2026-09-19 · same rubric, same numbers if you re-run it
- Code scan7 source files scanned13/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 4 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Findings (1)
- highShell command built from a string (injection risk)
exec.shell-concatdist/index.js: …= "win32" ? "start" : "xdg-open"; exec(`${openCmd} ${url}`); } const shutdown = () =>…
What the publisher says
From the q-ring repository's README, as published. We do not edit it. Read it on GitHub
q-ring
OS keychain secrets for AI coding agents, over MCP.
Stop pasting API keys into plain-text .env files or wrestling with clunky secret managers. q-ring securely anchors your credentials to your OS's native vault (macOS Keychain, Linux Secret Service, Windows Credential Vault) and supercharges them with mechanics from quantum physics.
📖 View the Official Documentation for a complete CLI reference, MCP prompt cookbooks, and architecture details.
Why q-ring?
- Superposition: Store one key with multiple states (dev/staging/prod) that collapse based on context.
- Entanglement: Link keys across projects so rotating one automatically updates them all.
- Tunneling: Create ephemeral, in-memory secrets that self-destruct after a set time or read count.
- Teleportation: Securely pack and share AES-256-GCM encrypted secret bundles.
- Seamless AI Integration: 44 built-in MCP tools for native use in Cursor, Kiro, and Claude Code.
🚀 Installation
q-ring is designed to be installed globally so it's available anywhere in your terminal. Pick your favorite package manager:
# pnpm (recommended)
pnpm add -g @i4ctime/q-ring
# npm
npm install -g @i4ctime/q-ring
# yarn
yarn global add @i4ctime/q-ring
# Homebrew (macOS / Linux)
brew install i4ctime/tap/qringDocker (MCP server)
The repo ships a Dockerfile that builds the MCP server and exposes it through mcp-proxy — useful for hosted MCP deployments (e.g. Glama) or keeping the server off the host entirely:
git clone https://github.com/I4cTime/q-ring.git
cd q-ring
docker build -t qring-mcp .
docker run --rm -p 8080:8080 qring-mcpShortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Grade history
- 2026-09-19restoreF → Cscore 65: Shell command built from a string (injection risk)
Install directly
Runs npx -y @i4ctime/q-ring on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add q-ring -- npx -y @i4ctime/q-ring
q-ring: common questions
- Is q-ring MCP server safe?
- With care: it is graded C, so read the findings first (65/100). Read the q-ring safety report
- How do I install q-ring?
- It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
- Does q-ring need an API key?
- Yes. The registry entry asks for
QRING_FILE_PASSPHRASE. - Is q-ring maintained?
- The last commit was 5 days ago (2026-09-16). The latest release is v0.17.6.
- What can I use instead of q-ring?
- Servers from other publishers that do the same job: Deja Vu MCP server.
Alternatives to q-ring
Same job from other publishers: the closest match first, then the best rated.
- Deja Vudeja-vu: local memory over the session histories of thirty-three coding agents.not reviewedEstablishedA