# Content Plan Builder

An MCP (Model Context Protocol) server that generates comprehensive Asana project plans from arbitrary content — text, PDFs, DOCX files, meeting transcripts, or any combination.

## Features

- **Multi-format Input**: Accepts text, PDF, DOCX, TXT, MD, HTML, CSV, and JSON files
- **AI-Powered Generation**: Uses Claude to create detailed project plans with:
  - 5 top-level tasks with 5-10 subtasks each
  - Realistic time estimates
  - Role-based assignments
  - Task dependencies
  - SMART goals
  - Key data points and metrics
- **Asana Integration**: Optionally create projects directly in Asana
- **Flexible Output**: Detailed structured format or compact array format

## Installation

```bash
# Clone the repository
git clone https://github.com/yourusername/content-plan-builder.git
cd content-plan-builder

# Install dependencies
npm install

# Build
npm run build
```

## Configuration

### Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `ANTHROPIC_API_KEY` | Yes | Anthropic API key for Claude |

### MCP Registration

Add to your `~/.mcp.json`:

```json
{
  "mcpServers": {
    "content-plan-builder": {
      "command": "node",
      "args": ["/path/to/content-plan-builder/dist/index.js"],
      "env": {
        "ANTHROPIC_API_KEY": "your-api-key"
      }
    }
  }
}
```

For Claude Desktop, add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "content-plan-builder": {
      "command": "node",
      "args": ["/path/to/content-plan-builder/dist/index.js"],
      "env": {
        "ANTHROPIC_API_KEY": "your-api-key"
      }
    }
  }
}
```

## Usage

### Tool: `plan_from_content`

#### Operations

| Operation | Description |
|-----------|-------------|
| `generate` | Create a project plan from inputs |
| `preview` | Preview plan without saving |
| `create` | Generate plan and create in Asana |

#### Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `operation` | string | `generate`, `preview`, or `create` |
| `inputs` | array | Array of input objects |
| `knowledgeBaseContext` | string | Additional context to include |
| `projectName` | string | Name for the generated project |
| `creativity` | string | `conservative`, `balanced`, or `expansive` |
| `outputFormat` | string | `detailed`, `compact`, or `both` |
| `asanaAccessToken` | string | Asana PAT (for create operation) |
| `asanaTeamGid` | string | Team GID for new project |
| `targetProjectGid` | string | Add to existing project |

#### Input Types

| Type | Description |
|------|-------------|
| `text` | Raw text content |
| `file` | File path to PDF, DOCX, TXT, MD, HTML, CSV, or JSON |
| `transcript` | Meeting transcript text |
| `meeting_notes` | Meeting notes text |

### Examples

#### Generate plan from text

```json
{
  "operation": "generate",
  "inputs": [
    {
      "type": "text",
      "content": "We need to build a new customer portal with user authentication, a dashboard showing order history, and the ability to track shipments..."
    }
  ],
  "projectName": "Customer Portal Development"
}
```

#### Generate from file

```json
{
  "operation": "generate",
  "inputs": [
    {
      "type": "file",
      "content": "/path/to/requirements.pdf"
    }
  ],
  "creativity": "expansive"
}
```

#### Combine multiple inputs

```json
{
  "operation": "generate",
  "inputs": [
    {
      "type": "transcript",
      "content": "Meeting transcript from kickoff call..."
    },
    {
      "type": "file",
      "content": "/path/to/scope-document.docx"
    }
  ],
  "knowledgeBaseContext": "This project is part of the Q2 digital transformation initiative...",
  "projectName": "Digital Transformation - Phase 1"
}
```

#### Create in Asana

```json
{
  "operation": "create",
  "inputs": [
    {
      "type": "transcript",
      "content": "Sprint planning meeting transcript..."
    }
  ],
  "projectName": "Sprint 14 Tasks",
  "asanaAccessToken": "your-asana-pat",
  "asanaTeamGid": "1234567890"
}
```

## Output Formats

### Detailed Format

Full structured plan with all metadata:

```json
{
  "projectGoal": "Build a customer-facing portal that enables...",
  "topLevelTasks": [
    {
      "name": "User Authentication System",
      "description": "Implement secure authentication...",
      "assignedTo": "Senior Developer",
      "estimate": "2 weeks",
      "blockedBy": "N/A",
      "subtasks": [...]
    }
  ],
  "keyDataPoints": ["500 concurrent users expected", ...],
  "keywordsAndPhrases": ["customer portal", "authentication", ...],
  "questionsAndExercises": ["What is the expected user growth rate?", ...],
  "smartGoals": ["Reduce customer support tickets by 30% within 3 months", ...],
  "additionalMaterials": ["UX design guidelines", ...]
}
```

### Compact Format

Array of all subtasks for easy import:

```json
[
  {
    "index": 1,
    "Parent-task": "User Authentication System",
    "Sub-Task": "Design authentication flow",
    "Task Description": "Create detailed flow diagrams...",
    "Assignee": "UX Designer",
    "Estimated Time": "3 days",
    "Dependencies": "N/A"
  }
]
```

## Creativity Levels

| Level | Description |
|-------|-------------|
| `conservative` | Stick closely to what is explicitly mentioned in the content |
| `balanced` | Include tasks that are mentioned or strongly implied (default) |
| `expansive` | Infer additional tasks for testing, documentation, deployment, etc. |

## Development

```bash
# Run in development mode
npm run dev

# Build
npm run build

# Start production server
npm start
```

## License

MIT