AIConductor
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@AIConductorrefine user onboarding flow"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
AIConductor
An open-source Model Context Protocol (MCP) server that orchestrates multi-stakeholder feature refinement and development execution workflows for AI-assisted software teams.
Overview
AIConductor gives your AI coding agent a structured, auditable pipeline — from raw feature idea to merged code. It exposes 39 MCP tools that any MCP-compatible agent (Claude, Copilot, Cursor, Cline, etc.) can call to drive tasks through two workflows:
Feature Refinement — Break a feature into discrete tasks, then route each task through a sequential stakeholder approval chain before any code is written.
Development Execution — Drive approved tasks through a Developer → Code Reviewer → QA lifecycle with full audit history.
Related MCP server: Spec MCP Server
Features
Multi-Stakeholder Reviews | Product Director → Architect → UI/UX Expert → Security Officer approval chain |
Development Pipeline | Developer → Code Reviewer → QA → Done with |
Real-time Dashboard | Kanban board at |
Multi-Repository | Manage tasks across multiple codebases from a single server |
Refinement Reports | Generate markdown/HTML/JSON reports of the full refinement process |
Workflow Checkpoints | Save and restore workflow state; rollback the last stakeholder decision |
Task Execution Planning | Dependency analysis with parallelisation suggestions |
Zero External Dependencies | Everything persisted in a local SQLite database |
Prerequisites
Docker and Docker Compose
An MCP-compatible AI agent (Claude Desktop, VS Code Copilot, Cursor, Cline, etc.)
Quick Start
git clone https://github.com/your-org/aiconductor.git
cd aiconductor
docker compose up -dThe MCP server and dashboard are now running. Connect your AI agent by adding the following to your MCP config:
Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"aiconductor": {
"command": "docker",
"args": ["exec", "-i", "-e", "DISABLE_DASHBOARD=true", "aiconductor-mcp", "node", "dist/bundle.js"]
}
}
}VS Code — .vscode/mcp.json or user settings
{
"mcp.servers": {
"aiconductor": {
"command": "docker",
"args": ["exec", "-i", "-e", "DISABLE_DASHBOARD=true", "aiconductor-mcp", "node", "dist/bundle.js"]
}
}
}Restart your agent. Open the dashboard at http://localhost:5111.
Workflows
Two slash-command workflows are included in .github/prompts/ and can be invoked directly from your agent.
/refine-feature — Feature Refinement
Turns a plain-text feature description into stakeholder-approved, implementation-ready tasks.
Feature Description
│
├─ Scope determination & context gathering
├─ Attachment analysis (images, docs, spreadsheets)
├─ Clarification questions
├─ SMART acceptance criteria generation
├─ Test scenario generation
├─ Task breakdown (5–8 tasks)
│
└─ Batched stakeholder review cycle
│
├─ Product Director → Architect → UI/UX Expert → Security Officer
│ │ │ │ │
│ reject reject reject reject
│ └──────────────────┴───────────────┴──────────────────┘
│ ▼
│ NeedsRefinement → restart
│
└─ All tasks reach ReadyForDevelopment ✓Tasks are processed in batches per role — a single role adoption covers all tasks in one pass, dramatically reducing context overhead.
/dev-workflow — Development Execution
Drives ReadyForDevelopment tasks through implementation to Done.
ReadyForDevelopment
└─→ InProgress ─→ InReview ─→ InQA ─→ Done ✓
│ │ │
└─────────────┴──────────┘
NeedsChanges → back to InProgressEach stage is handled by a distinct role: Developer (implements & tests), Code Reviewer (approves or requests changes), QA (verifies acceptance criteria).
Dashboard
Open http://localhost:5111 in your browser.
Kanban Board | Feature Details |
|
|
Kanban board — Task cards arranged by workflow status; empty columns collapse to a slim strip so all columns fit on screen without horizontal scrolling
Real-time updates — WebSocket connection pushes task state changes instantly to all open browser tabs
Detail panel — Per-feature acceptance criteria, test scenarios, clarifications, and refinement step progress
Multi-repo switcher — Switch between registered repositories from the sidebar
Reviewer presence — See which reviewers are currently active on a feature
MCP Tools Reference
Orchestration
Tool | Description |
| Returns the next role, system prompt, and required output fields for a task — the primary orchestration driver |
| Compressed overview of all task statuses and roles for a feature (~5 KB vs ~50 KB for full fetch) |
| Dependency analysis with optimal execution order and parallelisable phases |
| Find comparable tasks from past features to aid estimation |
| Cycle time, throughput, and bottleneck statistics |
Stakeholder Reviews
Tool | Description |
| Submit an approve/reject review with role-specific structured fields |
| Pre-flight check that all required fields are present before submitting |
| Current status, completed/pending reviews, and allowed transitions |
| Completion percentage and stakeholder progress across all tasks |
| Dry-run validation — check if a transition can proceed |
| Undo the most recent stakeholder decision on a task |
Development Pipeline
Tool | Description |
| Move a task through development stages (InProgress → InReview → InQA → Done) |
| Transition multiple tasks atomically in a single call |
| Get the next task to work on, optionally filtered by status |
| List all tasks matching a specific status |
| Assert every task in a feature has reached Done |
| Mark individual acceptance criteria as verified |
| Verify multiple criteria in one call |
Feature & Task Management
Tool | Description |
| Create a new feature with slug, name, and description |
| Update feature metadata (name, description) |
| Load full feature data including all tasks, criteria, and scenarios |
| List all features in a repository with task counts |
| Remove a feature and all associated tasks, reviews, and transitions |
| Add a task to a feature with acceptance criteria and test scenarios |
| Modify task properties (title, description, criteria, scenarios, dependencies) |
| Remove a task and all its data |
Refinement Tracking
Tool | Description |
| Record progress through the 8-step refinement workflow |
| Full refinement progress including step completion and criteria |
| Add feature-level acceptance criteria (before tasks are created) |
| Add feature-level test scenarios |
| Record a clarification question and answer |
| Store analysis results for an attached file or design |
| Export the full refinement process as markdown, HTML, or JSON |
Checkpoint Management
Tool | Description |
| Save current workflow state with a description |
| List all saved checkpoints for a feature |
| Resume from a previously saved checkpoint |
Repository Management
Tool | Description |
| Register a new repository namespace |
| List all registered repositories with task counts |
| Auto-detect the repository from the current working directory |
Stakeholder Roles
Role | Focus Areas | Key Output Fields |
Product Director | Market fit, user value, acceptance criteria quality |
|
Architect | Technical feasibility, design patterns, technology choices |
|
UI/UX Expert | Usability, accessibility, user behaviour |
|
Security Officer | Security requirements, compliance, risk assessment |
|
Project Structure
src/
├── index.ts # MCP server — tool definitions and request handling
├── AIConductor.ts # Business logic for all workflow operations
├── WorkflowValidator.ts # State machine — validates transitions and returns role prompts
├── DatabaseHandler.ts # SQLite CRUD operations
├── rolePrompts.ts # System prompts for each stakeholder role
├── websocket.ts # WebSocket server — real-time event broadcasting
├── dashboard.ts # Express web server (port 5111)
├── types.ts # TypeScript interfaces
└── client/ # React SPA (Vite)
.github/prompts/
├── refine-feature.prompt.md # Feature refinement workflow
└── dev-workflow.prompt.md # Development execution workflowDatabase:
Docker:
/data/tasks.db(persistent volumetask-review-data)Local:
./tasks.dbin project root
Local Development
npm install
npm run dev # Watch mode — recompiles on change
npm run build # Production build (server + client)
npm test # Run all tests with coverage
npm run lint # TypeScript and code quality lint
npm run dashboard # Start dashboard standalone (port 5111)To rebuild the Docker image after code changes:
docker compose up -d --buildCI/CD Pipeline
All pull requests automatically run through our GitHub Actions CI workflow, which includes:
Build — TypeScript compilation with
npm run buildLint — Code quality checks with
npm run lintTest — Jest tests with coverage tracking via
npm testCoverage — Coverage metrics uploaded to Codecov
See CONTRIBUTING.md for details on running these checks locally, understanding failures, and our branch protection rules.
Configuration
Variable | Default | Description |
|
| SQLite file location ( |
To reset all data:
docker compose down -v && docker compose up -dLicense
MIT
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/MohanTn/AIConductor'
If you have feedback or need assistance with the MCP directory API, please join our Discord server