QRStuff MCP Connection Helper

Official VS Code and Cursor IDE extension for the QRStuff platform. This extension automatically registers the QRStuff Model Context Protocol (MCP) server in your IDE configurations, provides a sidebar dashboard to monitor connection and authentication status across multiple AI editors, and enables AI assistants to seamlessly generate and manage QR codes.

Features

1. Zero-Config MCP Setup: On activation the extension auto-injects the QRStuff MCP server entry into:
   • VS Code / GitHub Copilot — ~/.config/Code/User/mcp.json (user-level servers key)
   • Cursor IDE — ~/.cursor/mcp.json (mcpServers key)
   • Google Antigravity — ~/.gemini/antigravity/mcp_config.json (mcpServers key)
   • OpenAI Codex — ~/.codex/config.toml (TOML [mcp_servers.qrstuff] section)
2. MCP Status Dashboard Sidebar: A branded Activity Bar panel that shows:
   • Live server health (online / offline indicator for mcp.qrstuff.ai).
   • Per-platform registration and authentication status cards for VS Code, Cursor, Antigravity, and OpenAI Codex.
   • One-click Authenticate, View Logs, and View Config buttons for each platform.
   • A global Configure & Register MCP button that re-runs auto-configuration.
3. Dynamic OAuth Flow: Authentication uses the MCP server's Dynamic Client Registration (RFC 7591). No static client IDs are embedded; each IDE performs its own registration and token exchange.
4. Legacy Config Cleanup: On every activation, the extension scrubs leftover static oauth.clientId entries and removes duplicate workspace-level MCP configurations to prevent auth failures.
5. AI Tool Integration: Empowers your editor's AI assistants (Cursor Chat, Copilot Chat, Antigravity, Codex) to directly execute QRStuff tools — generate QR codes, list projects, analyze scan metrics, and more.

Local Development and Compilation

To compile the extension locally from source:

1. Clone the repository and navigate into it:

   git clone [email protected]:qrstuff/qrstuff-vscode-extension.git
   cd qrstuff-vscode-extension
   

2. Install dependencies:

   npm install
   

3. Compile the TypeScript source code:

   npm run compile
   

4. Package the extension into a .vsix bundle:

   # Install the VS Code Extension CLI globally if not already installed
   npm install -g @vscode/vsce
   
   # Package the extension
   vsce package
   

   This will generate a file named qrstuff-vscode-extension-0.1.0.vsix in your root directory.

Local Testing Guide

1. Visual Studio Code

• Open VS Code.
• Go to the Extensions view (Ctrl+Shift+X or Cmd+Shift+X).
• Click the ... (Views and More Actions) button at the top right of the Extensions panel.
• Select Install from VSIX... and choose the compiled .vsix file.
• Verify that a new QRStuff MCP icon appears on the Activity Bar. Click it to open the MCP Status Dashboard sidebar.
• The dashboard will show the server health and VS Code's registration status.
• Click Authenticate on the VS Code card — this opens Copilot Chat with a QRStuff MCP prompt. Copilot will trigger the OAuth flow in your browser on first use.

2. Cursor IDE

• Open Cursor.
• Go to the Extensions tab and install the compiled .vsix file via Install from VSIX....
• Once installed and activated, the extension automatically writes the MCP server configuration to ~/.cursor/mcp.json.
• To verify the connection:
  • Open Cursor Settings (Ctrl+Shift+J or Cmd+Shift+J).
  • Go to Features > MCP.
  • You should see the qrstuff server registered with the URL https://mcp.qrstuff.ai/mcp.
  • Restart Cursor or click reload on the server, then ask Cursor Chat:

    "Generate a QR code for https://google.com using QRStuff"

3. Google Antigravity

• Verify that the extension is installed in your development environment.
• On startup, the extension automatically injects the qrstuff server configuration into ~/.gemini/antigravity/mcp_config.json.
• To verify:

  "mcpServers": {
    "qrstuff": {
      "serverURL": "https://mcp.qrstuff.ai/mcp"
    }
  }
  

• Start an Antigravity session and verify that the QRStuff tools (e.g., list_projects, generate_qr_code) are active and accessible.

4. OpenAI Codex

• The extension auto-appends a [mcp_servers.qrstuff] block to ~/.codex/config.toml if the ~/.codex directory exists.
• To authenticate, click Authenticate on the Codex card in the sidebar — this opens a terminal and runs codex mcp login qrstuff.
• Alternatively, run the command manually:

  codex mcp login qrstuff
  

Extension Architecture

License

MIT — see LICENSE for details.