rea
Reverse engineer anything with agents, from app behavior down to native binaries.
MCP server for Quantinuum Nexus, wrapping the qnexus SDK. Not affiliated with Quantinuum.
Skills que enseñan a la IA este tipo de trabajo; funcionan junto a este
Reverse engineer anything with agents, from app behavior down to native binaries.
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 4/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 12/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 16/100 |
Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala Qnexus MCP. Sigue https://mcp.popnx.com/i/blite-hq-qnexus-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Qnexus MCP para Claude en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "qnexus": { "command": "uvx", "args": [ "qnexus-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Qnexus MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
SettingsDeveloperEdit Config
{
"mcpServers": {
"qnexus": {
"command": "uvx",
"args": [
"qnexus-mcp"
]
}
}
}Usa Qnexus MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando Qnexus MCP o muestra una herramienta de Qnexus MCP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
QNEXUS_MCP_TOOLSETS Conjuntos de herramientas separados por comas: read,execute,manage,destructive (predeterminado: read) QNEXUS_MCP_ALLOW_SPEND Permitir la ejecución que consume créditos (HQC) (predeterminado: false) QNEXUS_MCP_ALLOW_HARDWARE Permitir objetivos QPU reales (predeterminado: false) QNEXUS_MCP_ALLOW_DESTRUCTIVE Permitir herramientas de eliminar/cancelar/archivar (predeterminado: false) QNEXUS_MCP_MAX_CREDITS Límite máximo de HQC por llamada; 0 bloquea todo gasto (predeterminado: 0). QNEXUS_MCP_MAX_OUTCOMES Límite Top-N de resultados de medición distintos devueltos por cada elemento de resultado (predeterminado: 100). QNEXUS_MCP_MAX_SUBMISSIONS_PER_MINUTE Límite de envíos en ventana deslizante; cada circuito de un lote cuenta como uno (predeterminado: 6). QNEXUS_MCP_PROJECTS Lista de proyectos permitidos separada por comas, aplicada en cada herramienta que modifica datos (predeterminado: todos los proyectos) Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar Qnexus MCP
Qnexus MCP se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar Qnexus MCP
B · Otros en Herramientas para desarrolladores que funcionan con ChatGPT
Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave
Funciona con Claude Code, pero hay que preparar algo antes
Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Qnexus MCP para Claude Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user qnexus -- uvx qnexus-mcp 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Qnexus MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user qnexus -- uvx qnexus-mcpDeberías ver Qnexus MCP en la lista como conectado
Usa Qnexus MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando Qnexus MCP o muestra una herramienta de Qnexus MCP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
QNEXUS_MCP_TOOLSETS Conjuntos de herramientas separados por comas: read,execute,manage,destructive (predeterminado: read) QNEXUS_MCP_ALLOW_SPEND Permitir la ejecución que consume créditos (HQC) (predeterminado: false) QNEXUS_MCP_ALLOW_HARDWARE Permitir objetivos QPU reales (predeterminado: false) QNEXUS_MCP_ALLOW_DESTRUCTIVE Permitir herramientas de eliminar/cancelar/archivar (predeterminado: false) QNEXUS_MCP_MAX_CREDITS Límite máximo de HQC por llamada; 0 bloquea todo gasto (predeterminado: 0). QNEXUS_MCP_MAX_OUTCOMES Límite Top-N de resultados de medición distintos devueltos por cada elemento de resultado (predeterminado: 100). QNEXUS_MCP_MAX_SUBMISSIONS_PER_MINUTE Límite de envíos en ventana deslizante; cada circuito de un lote cuenta como uno (predeterminado: 6). QNEXUS_MCP_PROJECTS Lista de proyectos permitidos separada por comas, aplicada en cada herramienta que modifica datos (predeterminado: todos los proyectos) Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Qnexus MCP para Cursor en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "qnexus": { "command": "uvx", "args": [ "qnexus-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Qnexus MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Usa Qnexus MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando Qnexus MCP o muestra una herramienta de Qnexus MCP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
QNEXUS_MCP_TOOLSETS Conjuntos de herramientas separados por comas: read,execute,manage,destructive (predeterminado: read) QNEXUS_MCP_ALLOW_SPEND Permitir la ejecución que consume créditos (HQC) (predeterminado: false) QNEXUS_MCP_ALLOW_HARDWARE Permitir objetivos QPU reales (predeterminado: false) QNEXUS_MCP_ALLOW_DESTRUCTIVE Permitir herramientas de eliminar/cancelar/archivar (predeterminado: false) QNEXUS_MCP_MAX_CREDITS Límite máximo de HQC por llamada; 0 bloquea todo gasto (predeterminado: 0). QNEXUS_MCP_MAX_OUTCOMES Límite Top-N de resultados de medición distintos devueltos por cada elemento de resultado (predeterminado: 100). QNEXUS_MCP_MAX_SUBMISSIONS_PER_MINUTE Límite de envíos en ventana deslizante; cada circuito de un lote cuenta como uno (predeterminado: 6). QNEXUS_MCP_PROJECTS Lista de proyectos permitidos separada por comas, aplicada en cada herramienta que modifica datos (predeterminado: todos los proyectos) Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Qnexus MCP para VS Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "qnexus": { "type": "stdio", "command": "uvx", "args": [ "qnexus-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Qnexus MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Usa Qnexus MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando Qnexus MCP o muestra una herramienta de Qnexus MCP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
QNEXUS_MCP_TOOLSETS Conjuntos de herramientas separados por comas: read,execute,manage,destructive (predeterminado: read) QNEXUS_MCP_ALLOW_SPEND Permitir la ejecución que consume créditos (HQC) (predeterminado: false) QNEXUS_MCP_ALLOW_HARDWARE Permitir objetivos QPU reales (predeterminado: false) QNEXUS_MCP_ALLOW_DESTRUCTIVE Permitir herramientas de eliminar/cancelar/archivar (predeterminado: false) QNEXUS_MCP_MAX_CREDITS Límite máximo de HQC por llamada; 0 bloquea todo gasto (predeterminado: 0). QNEXUS_MCP_MAX_OUTCOMES Límite Top-N de resultados de medición distintos devueltos por cada elemento de resultado (predeterminado: 100). QNEXUS_MCP_MAX_SUBMISSIONS_PER_MINUTE Límite de envíos en ventana deslizante; cada circuito de un lote cuenta como uno (predeterminado: 6). QNEXUS_MCP_PROJECTS Lista de proyectos permitidos separada por comas, aplicada en cada herramienta que modifica datos (predeterminado: todos los proyectos) Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --scope user qnexus -- uvx qnexus-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"qnexus": {
"command": "uvx",
"args": [
"qnexus-mcp"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"qnexus": {
"command": "uvx",
"args": [
"qnexus-mcp"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"qnexus": {
"type": "stdio",
"command": "uvx",
"args": [
"qnexus-mcp"
]
}
}
}QNEXUS_MCP_TOOLSETS envQNEXUS_MCP_ALLOW_SPEND envQNEXUS_MCP_ALLOW_HARDWARE envQNEXUS_MCP_ALLOW_DESTRUCTIVE envQNEXUS_MCP_MAX_CREDITS envQNEXUS_MCP_MAX_OUTCOMES envQNEXUS_MCP_MAX_SUBMISSIONS_PER_MINUTE envQNEXUS_MCP_PROJECTS envDescripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 18 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub Blite-HQ, dueña del repo
Último cambio de código: hace 29 días
Usa Apache-2.0
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Sin entradas en OSV.dev para qnexus-mcp@0.2.0
Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/blite-hq-qnexus-mcp)Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez hace 29 días, y la última versión (0.2.0) llegó al registro hace 4 meses.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.
En la misma categoría: GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.
Cloudflare MCP servers
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.
| Este Qnexus MCP | GitDiagram | Appllama | Cloudflare MCP | Omnara | Repowise | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | En la nube o instalado en tu equipo |
| Necesita clave | No | No | No | No | No | No |
| Se añade con + en Claude | No | No | No | Sí | No | No |
| Revisiones básicas | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 5/5 |
| Licencia | Apache-2.0 | MIT | MIT | Apache-2.0 | Apache-2.0 | AGPL-3.0 |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
A community Model Context Protocol (MCP) server for Quantinuum Nexus, wrapping the official qnexus Python SDK so any MCP-speaking agent (Claude Code, Cursor, VS Code, Codex, …) can inspect Nexus and, opt-in, run circuits on the free emulator.
Not affiliated with, endorsed by, or an official product of Quantinuum. "Quantinuum" and "Nexus" are
trademarks of their respective owners, used here nominatively to describe compatibility.
Early development. Read-only by default. Design and rationale live in docs/DESIGN.md; the research behind it is in docs/research/.
uv (the uvx command). On Windows, note the full path to uvx.exe (where uvx in a terminal) — GUI clients don't inherit your shell PATH.qnexus-mcp never handles your Nexus token. Authenticate out-of-band with the qnexus CLI (it opens your browser):
uvx --from qnexus qnx login
Inside Nexus JupyterHub, authentication is automatic; do not run qnx login there.
The launch command is the same everywhere — only the config file differs per client:
uvx qnexus-mcp==0.2.0 # read-only (default)
uvx qnexus-mcp==0.2.0 --toolsets read,execute # + run circuits on the free H2-1LE emulator
Pin a version (==0.2.0): uvx otherwise resolves the latest PyPI release on every launch — unpinned installs are neither reproducible nor auditable. Avoid 0.1.0 on Windows: its first tool call hangs (fixed in 0.2.0).
What to expect on startup: the first ever launch downloads the quantum SDK stack (1–3 min);
every launch takes ~30 s before the server responds — the SDK is imported up front, before the
MCP handshake. "Waiting for server to respond to
initialize" during that window is normal.
Settings → Developer → Local MCP servers → Edit Config (always use this button — the Microsoft Store build keeps the file under %LOCALAPPDATA%\Packages\Claude_*\..., not %APPDATA%\Claude), then add:
{
"mcpServers": { "nexus": { "command": "C:\\Users\\ \\.local\\bin\\uvx.exe", // or plain "uvx" on macOS/Linux "args": ["qnexus-mcp==0.2.0", "--toolsets", "read,execute"] } } }
Then quit Claude Desktop fully and reopen — the config is only read at cold start, and closing the window leaves the old process running (tray icon → Quit, or taskkill /F /IM claude.exe).
Command Palette → MCP: Open User Configuration (or a workspace .vscode/mcp.json):
{
"servers": { "nexus": { "type": "stdio", "command": "C:\\Users\\ \\.local\\bin\\uvx.exe", // or plain "uvx" on macOS/Linux "args": ["qnexus-mcp==0.2.0", "--toolsets", "read,execute"] } } }
claude mcp add nexus -- uvx qnexus-mcp==0.2.0 --toolsets read,execute
Same command; the config shape is one of the two JSON forms above (mcpServers vs servers + "type": "stdio") — check your client's docs for which file to put it in.
Something not working? See docs/TROUBLESHOOTING.md — it covers every failure mode observed in real client setups (wrong config path, slow first start, auth, rate limits, known Nexus-side errors).
| Flag | Env | Default | Effect |
|---|---|---|---|
--toolsets | QNEXUS_MCP_TOOLSETS | read | Capability domains to expose (read,execute,manage,destructive) |
--allow-spend | QNEXUS_MCP_ALLOW_SPEND | false | Permit credit-spending (HQC) execution |
--allow-hardware | QNEXUS_MCP_ALLOW_HARDWARE | false | Permit real-QPU targets |
--allow-destructive | QNEXUS_MCP_ALLOW_DESTRUCTIVE | false | Permit delete/cancel/archive |
--max-credits | QNEXUS_MCP_MAX_CREDITS | 0 | Hard per-call HQC ceiling; 0 blocks all spend |
--max-outcomes | QNEXUS_MCP_MAX_OUTCOMES | 100 | Top-N cap on distinct measurement outcomes returned per result (truncation is always reported) |
--max-submissions-per-minute | QNEXUS_MCP_MAX_SUBMISSIONS_PER_MINUTE | 6 | Sliding-window submission cap; each circuit in a batch counts as one |
--projects | QNEXUS_MCP_PROJECTS | *(all)* | Comma-separated project allowlist, enforced on every mutating tool |
Read-only by default. Anything that spends credits or mutates cloud state requires an explicit opt-in flag and an in-protocol confirmation, and the default execution backend is the free, noiseless H2-1LE emulator. Submissions are rate-limited, cloud mutations are serialized, destructive project operations resolve their target by exact name (never substring), and the server never reads, stores, or returns your Nexus token. Every control is enforced server-side; MCP tool annotations are treated as UX hints only. See docs/DESIGN.md §6–§7.
Prompt injection (conscious design decision). Everything Nexus returns — job names, project names, error messages, results — is attacker-influencable content (any Nexus user can name a job) and is treated as untrusted data. There is no structural tagging that separates "data" from "instructions" in today's MCP ecosystem; the structural boundary here is instead that injected content cannot escalate: every action with consequences (spending credits, targeting hardware, deleting anything) requires launch flags the agent cannot set *plus* an in-protocol human confirmation naming the exact target and cost. Injected text can at worst confuse the agent's reasoning — it cannot spend or destroy anything on its own. This residual risk is accepted and documented, not an omission.
Governance. This is an early-stage, single-maintainer project (see CODEOWNERS): releases are published by one person via GitHub-OIDC Trusted Publishing (no long-lived PyPI tokens). Pin a version (above) if that trust model matters for your deployment.
See CONTRIBUTING.md. Contributions are accepted under the Developer Certificate of Origin; sign off your commits with -s.