ask-a-human 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ayub Dahir
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,102 @@
+# ask-a-human
+
+An MCP server that lets Claude Code pause and ask you a question on Discord. You reply in a thread, and Claude continues with your answer.
+
+**Roadmap:**
+- Slack and Telegram support — March 3, 2026
+- Support for other coding agents and harnesses — March 6, 2026
+
+## Why
+
+This isn't a chat interface for Claude Code. It's an escape hatch for fully autonomous workflows.
+
+When you let Claude Code run on its own — refactoring a codebase, building a feature end-to-end, debugging a complex issue — it will occasionally hit a fork in the road: a trade-off you didn't anticipate, a design decision with no obvious right answer, or a critical juncture where moving forward without your input could mean wasted work. In those moments, Claude can choose to reach out to you on Discord, get your steer, and continue — rather than guessing wrong or stopping entirely.
+
+The goal is to let you stay away from the terminal while Claude works, and only get pulled in when it genuinely matters.
+
+## How it works
+
+1. Claude Code calls the `ask_human` tool with a question
+2. The bot posts the question to your Discord channel and @mentions you
+3. A thread is created for the question
+4. Claude Code waits until you reply in the thread
+5. Your reply is returned to Claude and it continues working
+
+## Setup
+
+### 1. Create a Discord bot
+
+1. Go to the [Discord Developer Portal](https://discord.com/developers/applications)
+2. Click **New Application** and give it a name
+3. Go to **Bot** in the sidebar
+4. Click **Reset Token** and copy it — this is your `DISCORD_BOT_TOKEN`
+5. Enable **Message Content Intent** (scroll down on the Bot page)
+6. Go to **OAuth2 > URL Generator**
+7. Check the `bot` scope
+8. Check these permissions: **Send Messages**, **Create Public Threads**, **Read Message History**, **Embed Links**
+9. Copy the generated URL and open it to invite the bot to your server
+
+### 2. Get your Discord IDs
+
+1. Open Discord Settings > Advanced > enable **Developer Mode**
+2. Right-click the channel where you want questions posted > **Copy Channel ID** — this is your `DISCORD_CHANNEL_ID`
+3. Right-click your username > **Copy User ID** — this is your `DISCORD_USER_ID`
+
+### 3. Add to Claude Code
+
+```sh
+claude mcp add \
+  -e DISCORD_BOT_TOKEN=your-bot-token \
+  -e DISCORD_CHANNEL_ID=your-channel-id \
+  -e DISCORD_USER_ID=your-user-id \
+  ask-a-human -- npx ask-a-human
+```
+
+That's it. Claude Code will now have access to the `ask_human` tool.
+
+## Tool
+
+### `ask_human`
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `question` | string | Yes | The question to ask |
+| `context` | string | No | Background context to help you understand the question |
+| `options` | string[] | No | Predefined choices when applicable |
+
+The question is posted as a rich embed in Discord with an @mention. If `context` or `options` are provided, they appear as additional fields in the embed.
+
+**Example:**
+
+```json
+{
+  "question": "Should I use PostgreSQL or SQLite for the local dev database?",
+  "context": "Building a REST API. Production will use PostgreSQL on Railway.",
+  "options": ["PostgreSQL (match prod)", "SQLite (simpler local setup)"]
+}
+```
+
+## Configuration
+
+| Environment Variable | Required | Default | Description |
+|---------------------|----------|---------|-------------|
+| `DISCORD_BOT_TOKEN` | Yes | — | Your Discord bot token |
+| `DISCORD_CHANNEL_ID` | Yes | — | Channel ID where questions are posted |
+| `DISCORD_USER_ID` | No | — | Your user ID for @mentions |
+| `ASK_TIMEOUT_MS` | No | `18000000` | Timeout in milliseconds (default: 5 hours, `0` for no timeout) |
+
+## Edge cases
+
+- **Multiple replies**: First thread reply wins; subsequent replies are ignored
+- **Empty messages**: Returned as `(empty message)`
+- **Bot messages**: Filtered out automatically
+- **Disconnections**: Discord.js auto-reconnects; pending questions persist in memory
+- **Shutdown**: Pending questions return an error; cleanup is graceful on SIGINT/SIGTERM
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and testing instructions.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,223 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { Client, EmbedBuilder, Events, GatewayIntentBits, ThreadAutoArchiveDuration, } from "discord.js";
+import { z } from "zod";
+// --- Environment validation ---
+const DISCORD_BOT_TOKEN = process.env.DISCORD_BOT_TOKEN;
+const DISCORD_CHANNEL_ID = process.env.DISCORD_CHANNEL_ID;
+const DISCORD_USER_ID = process.env.DISCORD_USER_ID;
+const ASK_TIMEOUT_MS = Number(process.env.ASK_TIMEOUT_MS) || 5 * 60 * 60 * 1000; // 5 hours default
+if (!DISCORD_BOT_TOKEN) {
+    console.error("Missing DISCORD_BOT_TOKEN");
+    process.exit(1);
+}
+if (!DISCORD_CHANNEL_ID) {
+    console.error("Missing DISCORD_CHANNEL_ID");
+    process.exit(1);
+}
+// --- Helpers ---
+const EMBED_DESCRIPTION_LIMIT = 4000;
+const EMBED_FIELD_VALUE_LIMIT = 1000;
+const THREAD_NAME_LIMIT = 100;
+function truncate(text, max) {
+    return text.length > max ? `${text.slice(0, max)}...` : text;
+}
+// Sentinels use Symbols to prevent collision with user input
+const SENTINEL_CANCELLED = Symbol("cancelled");
+const SENTINEL_TIMEOUT = Symbol("timeout");
+const SENTINEL_SHUTDOWN = Symbol("shutdown");
+const pendingQuestions = new Map();
+// --- Discord client setup ---
+const discordClient = new Client({
+    intents: [
+        GatewayIntentBits.Guilds,
+        GatewayIntentBits.GuildMessages,
+        GatewayIntentBits.MessageContent,
+    ],
+});
+// Cached channel reference, set during startup
+let targetChannel;
+// Listen for thread replies to pending questions
+discordClient.on(Events.MessageCreate, (message) => {
+    // Ignore bot messages
+    if (message.author.bot)
+        return;
+    // Only process messages in threads
+    if (!message.channel.isThread())
+        return;
+    const pending = pendingQuestions.get(message.channelId);
+    if (!pending)
+        return;
+    // First reply resolves; subsequent replies are ignored
+    const replyText = message.content || "(empty message)";
+    // Clean up timers and abort listener
+    if (pending.timeoutId)
+        clearTimeout(pending.timeoutId);
+    if (pending.keepaliveId)
+        clearInterval(pending.keepaliveId);
+    pendingQuestions.delete(message.channelId);
+    pending.resolve(replyText);
+});
+// --- MCP server setup ---
+const mcpServer = new McpServer({ name: "ask-a-human", version: "0.1.0" }, { capabilities: { logging: {}, tools: {} } });
+mcpServer.registerTool("ask_human", {
+    title: "Ask a Human",
+    description: "Pause execution and ask a human a question via Discord. The human replies in a Discord thread and execution resumes with their answer.",
+    inputSchema: {
+        question: z.string().describe("The specific question to ask the human"),
+        context: z
+            .string()
+            .optional()
+            .describe("Background context to help the human understand the question"),
+        options: z
+            .array(z.string())
+            .optional()
+            .describe("Predefined choices when applicable"),
+    },
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: true,
+    },
+}, async ({ question, context, options }, extra) => {
+    // Build embed
+    const embed = new EmbedBuilder()
+        .setColor(0x5865F2)
+        .setTitle("Claude Code needs your input")
+        .setDescription(truncate(question, EMBED_DESCRIPTION_LIMIT))
+        .setFooter({ text: "Reply in this thread to respond" });
+    if (context) {
+        embed.addFields({
+            name: "Context",
+            value: truncate(context, EMBED_FIELD_VALUE_LIMIT),
+        });
+    }
+    if (options && options.length > 0) {
+        const optionsList = options.map((o, i) => `${i + 1}. ${o}`).join("\n");
+        embed.addFields({
+            name: "Options",
+            value: truncate(optionsList, EMBED_FIELD_VALUE_LIMIT),
+        });
+    }
+    // Post message — mention in content (not embed) so the user gets pinged
+    const sentMessage = await targetChannel.send({
+        content: DISCORD_USER_ID ? `<@${DISCORD_USER_ID}>` : undefined,
+        embeds: [embed],
+    });
+    // Create a thread off the message (truncate the full name to fit the limit)
+    const thread = await sentMessage.startThread({
+        name: truncate(`Question: ${question}`, THREAD_NAME_LIMIT),
+        autoArchiveDuration: ThreadAutoArchiveDuration.OneDay,
+    });
+    // Wait for reply with keepalives, cancellation, and optional timeout
+    const reply = await new Promise((resolve) => {
+        const pending = { resolve };
+        function cleanup(sentinel) {
+            if (pending.timeoutId)
+                clearTimeout(pending.timeoutId);
+            if (pending.keepaliveId)
+                clearInterval(pending.keepaliveId);
+            pendingQuestions.delete(thread.id);
+            resolve(sentinel);
+        }
+        // Handle client-initiated cancellation via AbortSignal
+        const abortHandler = () => cleanup(SENTINEL_CANCELLED);
+        pending.abortHandler = abortHandler;
+        extra.signal.addEventListener("abort", abortHandler, { once: true });
+        // Progress keepalives every 25 seconds
+        pending.keepaliveId = setInterval(() => {
+            mcpServer.sendLoggingMessage({
+                level: "info",
+                data: "Waiting for human reply on Discord...",
+            });
+        }, 25_000);
+        // Optional timeout
+        if (ASK_TIMEOUT_MS > 0) {
+            pending.timeoutId = setTimeout(() => cleanup(SENTINEL_TIMEOUT), ASK_TIMEOUT_MS);
+        }
+        pendingQuestions.set(thread.id, pending);
+    });
+    if (reply === SENTINEL_CANCELLED) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "Request was cancelled by the client.",
+                },
+            ],
+            isError: true,
+        };
+    }
+    if (reply === SENTINEL_TIMEOUT) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Timed out after ${ASK_TIMEOUT_MS / 1000 / 60} minutes waiting for a human reply.`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    if (reply === SENTINEL_SHUTDOWN) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "Server is shutting down.",
+                },
+            ],
+            isError: true,
+        };
+    }
+    return {
+        content: [{ type: "text", text: reply }],
+    };
+});
+// --- Startup sequence ---
+async function main() {
+    // 1. Start Discord client and wait for it to be ready
+    const readyPromise = new Promise((resolve) => {
+        discordClient.once(Events.ClientReady, () => resolve());
+    });
+    await discordClient.login(DISCORD_BOT_TOKEN);
+    await readyPromise;
+    console.error("Discord client ready");
+    // 2. Fetch and validate the target channel once at startup
+    const channel = await discordClient.channels.fetch(DISCORD_CHANNEL_ID);
+    if (!channel || !channel.isTextBased() || channel.isDMBased()) {
+        console.error("Configured DISCORD_CHANNEL_ID is not a valid guild text channel");
+        process.exit(1);
+    }
+    targetChannel = channel;
+    console.error(`Target channel: ${DISCORD_CHANNEL_ID}`);
+    // 3. Connect MCP server to stdio transport
+    const transport = new StdioServerTransport();
+    await mcpServer.connect(transport);
+    console.error("MCP server connected (stdio)");
+}
+// --- Graceful shutdown ---
+async function shutdown() {
+    console.error("Shutting down...");
+    // Clean up all pending questions
+    for (const [, pending] of pendingQuestions) {
+        if (pending.timeoutId)
+            clearTimeout(pending.timeoutId);
+        if (pending.keepaliveId)
+            clearInterval(pending.keepaliveId);
+        pending.resolve(SENTINEL_SHUTDOWN);
+    }
+    pendingQuestions.clear();
+    discordClient.destroy();
+    await mcpServer.close();
+    process.exit(0);
+}
+process.on("SIGINT", shutdown);
+process.on("SIGTERM", shutdown);
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "ask-a-human",
+  "version": "0.1.0",
+  "description": "MCP server that lets Claude Code pause and ask humans for input via Discord",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "ask-a-human": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "mcp",
+    "claude",
+    "discord",
+    "human-in-the-loop",
+    "model-context-protocol"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "discord.js": "^14.25.1",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit"
+  }
+}