@achieveai/hitl-mcp-server 1.0.0

package/LICENSE

@@ -0,0 +1,20 @@
+GNU GENERAL PUBLIC LICENSE
+Version 3, 29 June 2007
+
+Copyright (C) 2025 Human-in-the-Loop MCP Server Contributors
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+For the full text of the GNU General Public License Version 3,
+please visit: https://www.gnu.org/licenses/gpl-3.0.txt

package/README.md

@@ -0,0 +1,306 @@
+# Human In The Loop MCP Server
+
+A Model Context Protocol (MCP) server that enables LLM agents to request human input through interactive dialog boxes. This tool provides a seamless way for AI agents to ask for clarification, make decisions with human guidance, and handle ambiguous situations.
+
+## Features
+
+- **Interactive Dialog UI**: Opens a browser-based dialog for user interaction
+- **Multiple Choice Questions**: Support for both single and multiple selection
+- **Custom Input**: "Other" field for free-text responses
+- **Cross-Platform**: Works on Windows, macOS, and Linux
+- **Timeout Support**: Configurable timeouts for time-sensitive decisions
+- **STDIO Transport**: Easy integration with Claude Desktop and other MCP clients
+
+## Installation
+
+### Prerequisites
+
+- Node.js 18+ and npm
+- A browser (for displaying dialogs)
+
+### From Source
+
+```bash
+# Clone the repository
+git clone <repository-url>
+cd hitl-mcp-server
+
+# Install dependencies
+npm install
+
+# Build the TypeScript code
+npm run build
+
+# Test the installation
+npm run dev
+```
+
+### Global Installation
+
+```bash
+# Build first
+npm run build
+
+# Install globally
+npm install -g .
+
+# Now you can run it from anywhere
+hitl-mcp-server
+```
+
+## Configuration
+
+Pre-configured examples are available in the `config/` directory for different MCP clients.
+
+### Claude Desktop Configuration
+
+Add the server to your Claude Desktop config file:
+
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Linux**: `~/.config/claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "human-in-the-loop": {
+      "command": "node",
+      "args": ["D:\\Source\\repos\\Hitl_MCP\\hitl-mcp-server\\dist\\index.js"],
+      "env": {
+        "NODE_ENV": "production"
+      }
+    }
+  }
+}
+```
+
+### VS Code Configuration
+
+Create `.vscode/mcp.json` in your workspace:
+
+```json
+{
+  "mcpServers": {
+    "human-in-the-loop": {
+      "command": "npx",
+      "args": ["-y", "@hitl/mcp-server"],
+      "env": {
+        "NODE_ENV": "production"
+      }
+    }
+  }
+}
+```
+
+### Cursor IDE Configuration
+
+Add to your Cursor settings:
+
+```json
+{
+  "mcpServers": {
+    "human-in-the-loop": {
+      "name": "Human In The Loop",
+      "command": "node",
+      "args": ["./dist/index.js"],
+      "cwd": "D:\\Source\\repos\\Hitl_MCP\\hitl-mcp-server",
+      "transport": "stdio",
+      "autoStart": false
+    }
+  }
+}
+```
+
+### NPM Global Installation
+
+```bash
+# Install globally from npm (when published)
+npm install -g @hitl/mcp-server
+
+# Then use in any config:
+{
+  "mcpServers": {
+    "human-in-the-loop": {
+      "command": "hitl-mcp-server"
+    }
+  }
+}
+```
+
+## Usage
+
+Once configured, the AI agent can use the `ask_human` tool to request input:
+
+### Example: Single Choice
+
+```javascript
+{
+  "question": "Which database should I use for this project?",
+  "options": [
+    {
+      "label": "PostgreSQL",
+      "value": "postgres",
+      "description": "Robust relational database with advanced features"
+    },
+    {
+      "label": "MongoDB",
+      "value": "mongo",
+      "description": "Flexible document database for unstructured data"
+    },
+    {
+      "label": "SQLite",
+      "value": "sqlite",
+      "description": "Lightweight embedded database"
+    }
+  ],
+  "allowMultiple": false,
+  "allowOther": true,
+  "context": "This is for a medium-scale web application with complex queries"
+}
+```
+
+### Example: Multiple Choice
+
+```javascript
+{
+  "question": "Which files should I include in the commit?",
+  "options": [
+    {
+      "label": "src/index.ts",
+      "value": "index"
+    },
+    {
+      "label": "src/utils.ts",
+      "value": "utils"
+    },
+    {
+      "label": "README.md",
+      "value": "readme"
+    }
+  ],
+  "allowMultiple": true,
+  "allowOther": false,
+  "context": "Several files have been modified"
+}
+```
+
+### Example: With Timeout
+
+```javascript
+{
+  "question": "Should I proceed with the deployment?",
+  "options": [
+    {
+      "label": "Yes, deploy now",
+      "value": "yes"
+    },
+    {
+      "label": "No, cancel",
+      "value": "no"
+    }
+  ],
+  "allowMultiple": false,
+  "allowOther": false,
+  "timeout": 30000  // 30 seconds
+}
+```
+
+## Response Format
+
+The tool returns a JSON response:
+
+```javascript
+{
+  "success": true,
+  "timestamp": 1703001234567,
+  "response": "selected_value",  // or array for multiple selection
+  "responseType": "selection"    // or "custom" for other text, "none" if skipped
+}
+```
+
+## Testing
+
+### Run Unit Tests
+
+```bash
+npm test
+```
+
+### Test Dialog Manager
+
+```bash
+npm run build
+node dist/test-client.js
+```
+
+This will open test dialogs to verify the UI is working correctly.
+
+### Manual Testing with MCP Inspector
+
+You can use the MCP Inspector tool to test the server:
+
+```bash
+npx @modelcontextprotocol/inspector node dist/index.js
+```
+
+## Development
+
+### Project Structure
+
+```
+hitl-mcp-server/
+├── src/
+│   ├── index.ts           # Main MCP server implementation
+│   ├── dialog-manager.ts  # Dialog UI and HTTP server
+│   └── test-client.ts     # Test client for dialog manager
+├── dist/                  # Compiled JavaScript (after build)
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+### Available Scripts
+
+- `npm run build` - Compile TypeScript to JavaScript
+- `npm run dev` - Run in development mode with auto-reload
+- `npm test` - Run unit tests
+- `npm run typecheck` - Check TypeScript types without building
+
+## Why Use This Tool?
+
+LLM agents often encounter situations requiring human judgment:
+
+1. **Ambiguous Requirements**: When instructions are unclear or contradictory
+2. **Critical Decisions**: Before performing irreversible actions
+3. **Multiple Valid Approaches**: When several solutions are equally valid
+4. **Missing Context**: When additional information is needed
+5. **Subjective Choices**: Design decisions, naming conventions, etc.
+
+This tool ensures AI agents can gracefully handle these situations by requesting human input rather than making assumptions or failing silently.
+
+## Troubleshooting
+
+### Dialog doesn't open
+
+- Check if port 3000-5000 range is available
+- Ensure your default browser is properly configured
+- Check the server logs for error messages
+
+### Timeout errors
+
+- Increase the timeout value in your request
+- Ensure the dialog window has focus
+
+### Server won't start
+
+- Check if another instance is already running
+- Verify Node.js version is 18 or higher
+- Run `npm install` to ensure all dependencies are installed
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.

package/config/claude-desktop.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "human-in-the-loop": {
+      "command": "node",
+      "args": ["D:\\Source\\repos\\Hitl_MCP\\hitl-mcp-server\\dist\\index.js"],
+      "env": {
+        "NODE_ENV": "production"
+      }
+    }
+  }
+}

package/config/cursor-mcp.json

@@ -0,0 +1,18 @@
+{
+  "mcpServers": {
+    "human-in-the-loop": {
+      "name": "Human In The Loop",
+      "description": "Interactive dialog system for getting human feedback",
+      "command": "node",
+      "args": ["./dist/index.js"],
+      "cwd": "D:\\Source\\repos\\Hitl_MCP\\hitl-mcp-server",
+      "env": {
+        "NODE_ENV": "production"
+      },
+      "transport": "stdio",
+      "autoStart": false,
+      "restartOnFailure": true,
+      "maxRestarts": 3
+    }
+  }
+}

package/config/vscode-mcp.json

@@ -0,0 +1,17 @@
+{
+  "mcpServers": {
+    "human-in-the-loop": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@hitl/mcp-server"
+      ],
+      "env": {
+        "NODE_ENV": "production"
+      },
+      "capabilities": {
+        "tools": true
+      }
+    }
+  }
+}

package/dist/__tests__/dialog-manager.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dialog-manager.test.d.ts.map

package/dist/__tests__/dialog-manager.test.d.ts.map

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

package/dist/__tests__/dialog-manager.test.js

@@ -0,0 +1,140 @@
+import { DialogManager } from '../dialog-manager.js';
+import { describe, it, expect, beforeEach, afterEach } from '@jest/globals';
+describe('DialogManager', () => {
+    let manager;
+    beforeEach(() => {
+        manager = new DialogManager();
+    });
+    afterEach(async () => {
+        await manager.close();
+    });
+    describe('initialization', () => {
+        it('should initialize the server on a random port', async () => {
+            const port = await manager.initialize();
+            expect(port).toBeGreaterThan(0);
+            expect(port).toBeLessThanOrEqual(65535);
+        });
+        it('should not reinitialize if already initialized', async () => {
+            const port1 = await manager.initialize();
+            const port2 = await manager.initialize();
+            expect(port1).toBe(port2);
+        });
+    });
+    describe('HTML generation', () => {
+        it('should escape HTML in user input', () => {
+            const manager = new DialogManager();
+            const html = manager.generateDialogHTML({
+                id: 'test',
+                question: '<script>alert("XSS")</script>',
+                options: [
+                    {
+                        label: '<b>Bold</b>',
+                        value: 'test',
+                        description: '"Quotes" & \'apostrophes\''
+                    }
+                ],
+                allowMultiple: false,
+                allowOther: true
+            });
+            expect(html).not.toContain('<script>alert("XSS")</script>');
+            expect(html).toContain('&lt;script&gt;alert(&quot;XSS&quot;)&lt;/script&gt;');
+            expect(html).not.toContain('<b>Bold</b>');
+            expect(html).toContain('&lt;b&gt;Bold&lt;/b&gt;');
+        });
+        it('should include context when provided', () => {
+            const manager = new DialogManager();
+            const html = manager.generateDialogHTML({
+                id: 'test',
+                question: 'Test question',
+                options: [{ label: 'Option 1', value: 'opt1' }],
+                allowMultiple: false,
+                allowOther: false,
+                context: 'Important context information'
+            });
+            expect(html).toContain('Important context information');
+            expect(html).toContain('Context:');
+        });
+        it('should not include context section when not provided', () => {
+            const manager = new DialogManager();
+            const html = manager.generateDialogHTML({
+                id: 'test',
+                question: 'Test question',
+                options: [{ label: 'Option 1', value: 'opt1' }],
+                allowMultiple: false,
+                allowOther: false
+            });
+            expect(html).not.toContain('Context:');
+        });
+    });
+    describe('dialog options', () => {
+        it('should render radio buttons for single choice', () => {
+            const manager = new DialogManager();
+            const html = manager.generateDialogHTML({
+                id: 'test',
+                question: 'Choose one',
+                options: [
+                    { label: 'A', value: 'a' },
+                    { label: 'B', value: 'b' }
+                ],
+                allowMultiple: false,
+                allowOther: false
+            });
+            expect(html).toContain('type="radio"');
+            expect(html).not.toContain('type="checkbox"');
+        });
+        it('should render checkboxes for multiple choice', () => {
+            const manager = new DialogManager();
+            const html = manager.generateDialogHTML({
+                id: 'test',
+                question: 'Choose many',
+                options: [
+                    { label: 'A', value: 'a' },
+                    { label: 'B', value: 'b' }
+                ],
+                allowMultiple: true,
+                allowOther: false
+            });
+            expect(html).toContain('type="checkbox"');
+            expect(html).not.toContain('type="radio"');
+        });
+        it('should include other field when allowed', () => {
+            const manager = new DialogManager();
+            const html = manager.generateDialogHTML({
+                id: 'test',
+                question: 'Choose',
+                options: [{ label: 'A', value: 'a' }],
+                allowMultiple: false,
+                allowOther: true
+            });
+            expect(html).toContain('other-input');
+            expect(html).toContain('Other (please specify)');
+        });
+        it('should not include other field when not allowed', () => {
+            const manager = new DialogManager();
+            const html = manager.generateDialogHTML({
+                id: 'test',
+                question: 'Choose',
+                options: [{ label: 'A', value: 'a' }],
+                allowMultiple: false,
+                allowOther: false
+            });
+            expect(html).not.toContain('other-input');
+            expect(html).not.toContain('Other (please specify)');
+        });
+    });
+    describe('timeout handling', () => {
+        it('should reject with timeout error after specified duration', async () => {
+            await manager.initialize();
+            const dialogPromise = manager.showDialog({
+                id: 'timeout-test',
+                question: 'This will timeout',
+                options: [{ label: 'Option', value: 'opt' }],
+                allowMultiple: false,
+                allowOther: false,
+                timeout: 100
+            });
+            await expect(dialogPromise).rejects.toThrow('Dialog timeout');
+        }, 10000);
+    });
+});
+//# sourceMappingURL=dialog-manager.test.js.map

package/dist/__tests__/dialog-manager.test.js.map

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

package/dist/dialog-manager.d.ts

@@ -0,0 +1,36 @@
+import { EventEmitter } from 'events';
+export interface DialogOption {
+    label: string;
+    value: string;
+    description?: string;
+}
+export interface DialogRequest {
+    id: string;
+    question: string;
+    options: DialogOption[];
+    allowMultiple: boolean;
+    allowOther: boolean;
+    context?: string;
+    timeout?: number;
+}
+export interface DialogResponse {
+    id: string;
+    selectedValues: string[];
+    otherText?: string;
+    timestamp: number;
+}
+export declare class DialogManager extends EventEmitter {
+    private app;
+    private port;
+    private pendingDialogs;
+    private server;
+    private isInitialized;
+    constructor(port?: number);
+    private setupRoutes;
+    private generateDialogHTML;
+    private escapeHtml;
+    initialize(): Promise<number>;
+    showDialog(request: DialogRequest): Promise<DialogResponse>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=dialog-manager.d.ts.map

package/dist/dialog-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog-manager.d.ts","sourceRoot":"","sources":["../src/dialog-manager.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,aAAc,SAAQ,YAAY;IAC7C,OAAO,CAAC,GAAG,CAAU;IACrB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,cAAc,CAKnB;IACH,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,aAAa,CAAkB;gBAE3B,IAAI,GAAE,MAAU;IAQ5B,OAAO,CAAC,WAAW;IAgDnB,OAAO,CAAC,kBAAkB;IAqW1B,OAAO,CAAC,UAAU;IAWZ,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAoB7B,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAkC3D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAU7B"}