auq-mcp-server 0.1.1 → 0.1.3

package/README.md

@@ -12,7 +12,7 @@
 
 ## What does it do?
 
-Through the MCP server, your LLM can generate question sets consisting of multiple-choice, single-choice, and free-text questions (with an "Other" option for custom input) while coding or working, and wait for your answers.
+Through this MCP server, your LLM can generate question sets consisting of multiple-choice, single-choice, and free-text questions (with an "Other" option for custom input) while coding or working, and wait for your answers.
 
 You can keep the `auq` CLI running in advance, or start it when questions are pending. With simple arrow key navigation, you can select answers and send them back to the AI—all within a clean terminal interface.
 
@@ -61,14 +61,27 @@ npx auq
 
 ## 🔌 MCP Server Configuration
 
-### Claude Desktop
+### Cursor
 
-Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=ask-user-questions&config=eyJlbnYiOnt9LCJjb21tYW5kIjoibnB4IC15IGF1cS1tY3Atc2VydmVyIHNlcnZlciJ9)
+
+### Claude Code (CLI)
+
+**Method 1: Using CLI** (Recommended)
+
+```bash
+claude mcp add --transport stdio ask-user-questions -- npx -y auq-mcp-server server
+```
+
+**Method 2: Manual Configuration**
+
+Add to `.mcp.json` in your project root (for team-wide sharing):
 
 ```json
 {
   "mcpServers": {
-    "auq": {
+    "ask-user-questions": {
+      "type": "stdio",
       "command": "npx",
       "args": ["-y", "auq-mcp-server", "server"]
     }
@@ -76,25 +89,79 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
 }
 ```
 
-**Restart Claude Desktop** after saving.
-
-### Cursor / Other MCP Clients
+Or add to `~/.claude.json` for global access across all projects.
 
-Add to `.mcp.json` in your project root:
+**With environment variables:**
 
 ```json
 {
   "mcpServers": {
-    "auq": {
+    "ask-user-questions": {
+      "type": "stdio",
       "command": "npx",
       "args": ["-y", "auq-mcp-server", "server"],
-      "env": {}
+      "env": {
+        "AUQ_SESSION_DIR": "${AUQ_SESSION_DIR}"
+      }
     }
   }
 }
 ```
 
-Restart your client after configuration.
+**Manage servers:**
+```bash
+claude mcp list              # View all servers
+claude mcp get ask-user-questions   # Server details
+claude mcp remove ask-user-questions  # Remove server
+```
+
+**Verify setup:** Type `/mcp` in Claude Code to check server status.
+
+### Codex CLI
+
+Add to `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.ask-user-questions]
+command = "npx"
+args = ["-y", "auq-mcp-server", "server"]
+```
+
+**Full configuration example** (with optional settings):
+
+```toml
+[mcp_servers.ask-user-questions]
+command = "npx"
+args = ["-y", "auq-mcp-server", "server"]
+
+# Optional: Additional environment variables
+# env = { "AUQ_SESSION_DIR" = "/custom/path" }
+
+# Optional: Whitelist additional env vars
+# env_vars = ["AUQ_SESSION_DIR"]
+
+# Optional: Working directory
+# cwd = "/Users/<user>/projects"
+```
+
+Restart Codex CLI after saving the configuration.
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "ask-user-questions": {
+      "command": "npx",
+      "args": ["-y", "auq-mcp-server", "server"]
+    }
+  }
+}
+```
+
+**Restart Claude Desktop** after saving.
 
 ---
 

package/dist/bin/auq.js

@@ -1,5 +1,4 @@
 #!/usr/bin/env node
-import { exec } from "child_process";
 import { readFileSync } from "fs";
 import { dirname, join } from "path";
 import { fileURLToPath } from "url";
@@ -54,26 +53,10 @@ if (command === "--version" || command === "-v") {
 }
 // Handle 'server' command
 if (command === "server") {
-    console.log("Starting MCP server...");
-    const serverProcess = exec("node dist/src/server.js", (error, stdout, stderr) => {
-        if (error) {
-            console.error(`Error starting server: ${error.message}`);
-            process.exit(1);
-        }
-        if (stderr) {
-            console.error(stderr);
-        }
-        console.log(stdout);
-    });
-    // Forward signals
-    process.on("SIGINT", () => {
-        serverProcess.kill("SIGINT");
-        process.exit(0);
-    });
-    process.on("SIGTERM", () => {
-        serverProcess.kill("SIGTERM");
-        process.exit(0);
-    });
+    // Import and start the MCP server directly
+    // This avoids spawning a subprocess and outputting non-JSON to stdout
+    await import("../src/server.js");
+    // The server will start and handle stdio communication
     // Keep process alive
     await new Promise(() => { });
 }

package/dist/src/tui/components/StepperView.js

@@ -1,6 +1,7 @@
 import { Box, Text, useApp, useInput } from "ink";
 import React, { useEffect, useRef, useState } from "react";
 import { SessionManager } from "../../session/SessionManager.js";
+import { getSessionDirectory } from "../../session/utils.js";
 import { theme } from "../theme.js";
 import { ConfirmationDialog } from "./ConfirmationDialog.js";
 import { QuestionDisplay } from "./QuestionDisplay.js";
@@ -77,7 +78,7 @@ export const StepperView = ({ onComplete, sessionId, sessionRequest, }) => {
     const handleConfirm = async (userAnswers) => {
         setSubmitting(true);
         try {
-            const sessionManager = new SessionManager();
+            const sessionManager = new SessionManager({ baseDir: getSessionDirectory() });
             await sessionManager.saveSessionAnswers(sessionId, {
                 answers: userAnswers,
                 sessionId,
@@ -114,7 +115,7 @@ export const StepperView = ({ onComplete, sessionId, sessionRequest, }) => {
     // Handle session rejection
     const handleRejectSession = async (reason) => {
         try {
-            const sessionManager = new SessionManager();
+            const sessionManager = new SessionManager({ baseDir: getSessionDirectory() });
             await sessionManager.rejectSession(sessionId, reason);
             // Call onComplete with rejection flag
             if (onComplete) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "auq-mcp-server",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "main": "dist/index.js",
   "bin": {
     "auq": "dist/bin/auq.js"