Package Exports

ai-expert-workflow-mcp
ai-expert-workflow-mcp/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (ai-expert-workflow-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

AI Expert Workflow MCP

An MCP (Model Context Protocol) server that implements the AI Expert Workflow using OpenRouter API for AI capabilities. This project allows you to consult with AI experts in product management, UX design, and software architecture to plan and develop your projects. It can be used standalone or with Task Master for task management (optional).

🚀 Quick Start for End Users

Standalone Usage (Recommended)

Install AI Expert Workflow globally:
```
npm install -g ai-expert-workflow-mcp
```
Get an OpenRouter API key:
- OpenRouter API key for AI Expert Workflow: Get one here

Generate a PRD for your project:

# Set your API key
export OPENROUTER_API_KEY=your_key_here

# Generate a PRD
npx ai-expert-workflow-generate "Your detailed project description"

Review your PRD in prd.md

Optional: Task Master Integration

If you also want to use Task Master for task management (optional):

Install Task Master globally:
```
npm install -g task-master-ai
```
Get the additional API keys:
- Anthropic API key for Task Master AI: Get one here
- Perplexity API key (optional) for Task Master AI enhanced research capability: Get one here

Configure your Cursor settings with both MCPs:

{
  "mcpServers": {
    "ai-expert-workflow": {
      "command": "npx",
      "args": ["-y", "ai-expert-workflow-mcp"],
      "env": {
        "OPENROUTER_API_KEY": "YOUR_OPENROUTER_API_KEY_HERE",
        "OPENROUTER_MODEL": "tngtech/deepseek-r1t-chimera:free",
        "MAX_TOKENS": 8000,
        "TEMPERATURE": 0.7
      }
    },
    "taskmaster-ai": {
      "command": "npx",
      "args": ["-y", "task-master-ai"],
      "env": {
        "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
        "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE",
        "MODEL": "claude-3-sonnet-20240229",
        "PERPLEXITY_MODEL": "sonar-pro",
        "MAX_TOKENS": 64000,
        "TEMPERATURE": 0.2,
        "DEFAULT_SUBTASKS": 5,
        "DEFAULT_PRIORITY": "medium"
      }
    }
  }
}

Note on models: With OpenRouter, you can choose from many AI models beyond Claude:

For creative tasks: openai/gpt-4o, anthropic/claude-3-opus-20240229
For balanced performance: anthropic/claude-3-sonnet-20240229, mistral/mistral-large
For faster, cost-effective options: openai/gpt-3.5-turbo, anthropic/claude-3-haiku-20240307
Other options: google/gemini-pro, meta/llama-3-70b, cohere/command-r

See the complete list of OpenRouter models for all available options.

Enable the MCPs in your Cursor settings.

Complete Workflow Examples

Option 1: Standalone PRD Generation (Recommended)

# Install AI Expert Workflow globally
npm install -g ai-expert-workflow-mcp

# Set your OpenRouter API key
export OPENROUTER_API_KEY=your_openrouter_key_here

# Generate a PRD with one command
npx ai-expert-workflow-generate "I want to build a recipe app that helps users find recipes based on ingredients they already have at home. Target users are home cooks who want to reduce food waste and save money."

This single command will:

Generate a comprehensive PRD document based on your description
Save it as prd.md in your current directory
Also save it in Task Master compatible format (at scripts/prd.txt) in case you want to use Task Master later

Option 2: Interactive Conversation Workflow

Step 1: Plan your Product with the AI Product Manager

User: Can you start the AI Expert Workflow for my new mobile recipe app?

AI: I'll start the AI Expert Workflow to help you plan your mobile recipe app. What specific aspect would you like to begin with?

User: Let's create a PRD with the AI Product Manager. I want to build a recipe app that helps users find recipes based on ingredients they already have at home.

AI: [Asks clarifying questions about target users, key features, monetization, etc.]

User: [Provides detailed responses about the app vision]

Step 2: Generate the PRD

User: Can you generate a complete PRD document based on our consultation?

AI: [Generates comprehensive PRD with MVP focus and lean startup validation plan]

AI: Document saved to PRD.md. You can now review it and use it for your development planning.

Step 3 (Optional): Use Task Master to Create Tasks

If you want to break down your PRD into development tasks, you can optionally use Task Master:

User: Can you parse the PRD at scripts/prd.txt and generate tasks?

AI: [Task Master parses the PRD and creates a structured list of tasks with priorities]

User: What's the next task I should work on?

AI: [Task Master suggests the highest priority task with implementation details]

This streamlined workflow transforms your idea into a well-planned product with a comprehensive PRD. You can then optionally use Task Master to break it down into development tasks.

Features

Standalone PRD Generation: Generate comprehensive PRDs without any dependencies
Consult with AI experts in three key roles:
- AI Product Manager
- AI UX Designer
- AI Software Architect
Generate comprehensive documents:
- Product Requirements Document (PRD) with MVP focus and lean startup approach
- UX Design Document with prototype descriptions and user testing plans
- Software Architecture Specification with functional specifications and technical design
Optional Task Master integration: Can be used with Task Master if you want task management
Powered by OpenRouter API for maximum flexibility across AI models:
- Works with OpenAI models (GPT-4o, GPT-4-turbo, GPT-3.5-turbo)
- Works with Anthropic models (Claude 3 Opus, Sonnet, Haiku)
- Works with other models (Google Gemini, Mistral, Llama, Cohere, etc.)

Benefits of Using AI Expert Workflow MCP

Complete Project Planning: Get expert guidance through the entire product planning process
Standalone Operation: Works completely on its own without requiring Task Master
Lean Startup Approach: Focus on MVP definition and validation plans
User-Centered Design: Create user experiences based on solid UX principles
Technical Excellence: Design scalable architectures that meet your requirements
Optional Task Master Integration: Convert your PRD into development tasks if needed
Cursor Integration: Seamless workflow within your development environment
Model Flexibility: Choose from dozens of AI models through OpenRouter API
- Use high-performance models (Claude Opus, GPT-4o) for complex planning
- Use balanced models (Claude Sonnet, Mistral) for everyday work
- Use fast models (Claude Haiku, GPT-3.5) for quick iterations

Installation

Global Installation (Recommended)

The easiest way to use AI Expert Workflow MCP is to install it directly from npm:

npm install -g ai-expert-workflow-mcp

This makes the ai-expert-workflow-mcp command globally available in your terminal.

Local Development

Clone the repository:

git clone https://github.com/bacoco/ai-expert-workflow-mcp.git
cd ai-expert-workflow-mcp

Install dependencies:
```
npm install
```
Configure environment variables:
- Copy .env.example to .env
- Add your OpenRouter API key to the .env file (get one from https://openrouter.ai/keys)
Build the project:
```
npm run build
```
Start the server:
```
npm start
```

Run tests (optional):

# Run essential tests (recommended for quick verification)
npm run test:essential

# Run individual tests
npm run test:mcp-only        # Test only the MCP server
npm run test:openrouter-direct  # Test only the OpenRouter API

# Run JavaScript tests
npm test

# Run TypeScript tests
npm run test:ts

# Or use the shell scripts
./tests/run-js-test.sh
./tests/run-ts-test.sh

# Run comprehensive tests (builds and runs both JS and TS tests)
./tests/run-comprehensive-test.sh

Test results will be saved to tests/results/result_test.md and tests/results/result_test_ts.md.

IMPORTANT: The tests will fail with the default API key. To verify your OpenRouter API key without modifying the .env file, use one of these scripts:

Verify and update in one step:
npm run verify-and-update YOUR_API_KEY
Or run the steps separately:
# Verify your API key
npm run verify-openrouter YOUR_API_KEY

# Update the MCP configuration
npm run update-config YOUR_API_KEY

Usage with Cursor AI

Add the MCP configuration to your editor:

{
  "mcpServers": {
    "ai-expert-workflow": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "${workspaceFolder}",
      "env": {
        "OPENROUTER_API_KEY": "${env:OPENROUTER_API_KEY}",
        "OPENROUTER_MODEL": "tngtech/deepseek-r1t-chimera:free",
        "MAX_TOKENS": 4000,
        "TEMPERATURE": 0.7,
        "MCP_TIMEOUT": "120000",
        "DEBUG": "mcp"
      }
    },
    "taskmaster-ai": {
      "command": "npx",
      "args": ["-y", "task-master-ai"],
      "env": {
        "OPENROUTER_API_KEY": "${env:OPENROUTER_API_KEY}",
        "OPENROUTER_MODEL": "openai/gpt-4-turbo",
        "MAX_TOKENS": 8000,
        "TEMPERATURE": 0.7,
        "DEFAULT_SUBTASKS": 5,
        "DEFAULT_PRIORITY": "medium"
      }
    }
  }
}

Enable the MCP in your editor settings
Use natural language to interact with the AI Expert Workflow:

Can you start the AI Expert Workflow for my project?
Can you consult with the AI Product Manager to create a PRD for my project?
Can you generate a complete PRD document based on our consultation?

After generating your PRD, use Task Master to create tasks:

Can you parse the PRD at scripts/prd.txt and generate tasks?

AI Expert Workflow

The workflow consists of three main phases:

1. Product Definition (AI Product Manager)

The Product Manager helps you create a PRD that includes:

Product overview and problem statement
User personas and user stories
Feature requirements with priorities
MVP scope definition
Business model
Lean startup validation plan

2. UX Design (AI UX Designer)

The UX Designer helps you create a UX document that includes:

User personas and journey maps
Information architecture
Wireframe descriptions
Prototype specifications
User testing plans

3. Technical Architecture (AI Software Architect)

The Software Architect helps you create a specification that includes:

System architecture
Technology stack recommendations
Functional specifications
Technical design
Integration requirements

Standalone PRD Generation

The AI Expert Workflow is designed to work completely standalone:

# Install the AI Expert Workflow MCP
npm install -g ai-expert-workflow-mcp

# Set your OpenRouter API key
export OPENROUTER_API_KEY=your_openrouter_key_here

# Generate a PRD with the default model
npx ai-expert-workflow-generate "Your detailed project description"

# Or specify a different model for more creative or complex projects
MODEL=openai/gpt-4o npx ai-expert-workflow-generate "Your detailed project description"

This script:

Generates a comprehensive PRD document based on your description
Saves it as prd.md in your current directory
Also saves it in Task Master compatible format (at scripts/prd.txt) in case you want to use Task Master later

Optional: Task Master Integration

Note: Task Master integration is completely optional. You can use AI Expert Workflow on its own to generate PRDs.

If you do want to use Task Master, you'll need these API keys:

OpenRouter API key for AI Expert Workflow (get one from OpenRouter)

Anthropic API key for Task Master AI (get one from Anthropic)

Perplexity API key (optional) for Task Master AI enhanced research capabilities (get one from Perplexity)

Using Task Master to Parse the PRD

If you want to convert your PRD into development tasks, you can use Task Master in one of two ways:

Option 1: MCP Integration (For Cursor users)

Add the Task Master MCP to your editor configuration:

"mcpServers": {
  "taskmaster-ai": {
    "command": "npx",
    "args": ["-y", "task-master-ai"],
    "env": {
      "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
      "MODEL": "claude-3-sonnet-20240229"
    }
  }
}

Then ask your AI assistant:

Can you parse the PRD at scripts/prd.txt and generate tasks?

Option 2: Command Line Usage

Install Task Master:
```
npm install -g task-master-ai
```
Parse the PRD:
```
task-master parse-prd scripts/prd.txt
```

Utility Scripts

The project includes utility scripts to demonstrate Task Master integration:

generate-task-master-files.js: Creates sample PRD and Task Master integration files using the MCP implementation
generate-task-master-files-simple.js: Creates sample PRD and Task Master integration files without using MCP

These scripts are useful for testing and understanding how the integration works.

For More Information

See the Create-MCP.md file for a complete guide on creating your own AI Expert Workflow MCP server from scratch.

For details on OpenRouter API integration, see OPENROUTER.md.

For Task Master AI documentation, see Task Master on npm.

License

MIT