# Claude Book Agent

An AI-powered **Model Context Protocol (MCP)** server for **Claude Desktop** that automates the generation of structured children's books.

This project demonstrates how an AI agent can orchestrate a multi-step book creation workflow, maintain generation state, and produce publication-ready content for further editing and publishing.

## Overview

Creating a high-quality children's book involves much more than simply generating text. The process requires planning the book structure, generating consistent content, handling long-running tasks, preserving progress, and producing output that can be refined for publication.

This project explores how an AI agent can automate that workflow using the **Model Context Protocol (MCP)** and **Claude Desktop**.

The current implementation provides a working MCP server that generates structured children's book content while maintaining generation state. It serves as the foundation for a larger autonomous publishing pipeline that will eventually generate stories, activities, poems, illustration prompts, and publication-ready assets with minimal manual intervention.

## Features

### Current Capabilities

* MCP server compatible with Claude Desktop
* AI-assisted generation of structured children's books
* Persistent state management to resume interrupted generation
* Markdown export of generated content
* Built with Node.js and JavaScript
* Extensible foundation for future AI publishing workflows

### Planned Enhancements

* Modular story generation engine
* Illustration prompt generation
* Activity page generation
* Poetry generation
* DOCX and PDF export improvements
* Amazon KDP formatting
* Metadata generation
* Automated quality review
* Social media content generation
* End-to-end autonomous publishing pipeline

## Technology Stack

| Technology                       | Purpose                           |
| -------------------------------- | --------------------------------- |
| **Node.js**                      | Runtime environment               |
| **JavaScript**                   | Core application development      |
| **Model Context Protocol (MCP)** | Integration with Claude Desktop   |
| **Claude Desktop**               | AI client invoking the MCP server |
| **Markdown**                     | Generated book output format      |
| **Git & GitHub**                 | Version control and collaboration |
## Technology Stack

| Technology                       | Purpose                           |
| -------------------------------- | --------------------------------- |
| **Node.js**                      | Runtime environment               |
| **JavaScript**                   | Core application development      |
| **Model Context Protocol (MCP)** | Integration with Claude Desktop   |
| **Claude Desktop**               | AI client invoking the MCP server |
| **Markdown**                     | Generated book output format      |
| **Git & GitHub**                 | Version control and collaboration |

## Architecture

```text
                    User
                      │
                      ▼
              Claude Desktop
                      │
               Model Context Protocol (MCP)
                      │
                      ▼
            Claude Book Agent (Node.js)
                      │
          ┌───────────┼───────────┐
          │           │           │
          ▼           ▼           ▼
   Story Generation  State Management  Export Engine
          │           │           │
          └───────────┼───────────┘
                      │
                      ▼
            Generated Children's Book
```

The MCP server acts as the orchestration layer between Claude Desktop and the book generation pipeline. It manages generation requests, preserves state, and produces structured output that can be extended into a complete publishing workflow.

---

## Project Structure

```text
book-pipeline-mcp/
│
├── index.js                 # MCP server implementation
├── package.json             # Project configuration
├── package-lock.json        # Dependency lock file
├── book_output.md           # Sample generated output
├── book_state.json          # Persistent generation state
├── README.md                # Project documentation
└── .gitignore
```

---

## Getting Started

### Prerequisites

* Node.js
* Claude Desktop
* Git

### Clone the repository

```bash
git clone https://github.com/YOUR_USERNAME/YOUR_REPOSITORY.git
```

### Install dependencies

```bash
npm install
```

### Start the MCP server

```bash
node index.js
```

Configure Claude Desktop to use this server through its MCP configuration.

## Why I Built This

I wanted to explore how AI agents can automate complete workflows instead of solving isolated tasks.

Children's book creation involves multiple stages such as planning, content generation, maintaining consistency, exporting content, and preparing it for publishing. Rather than treating each task independently, this project demonstrates how an MCP server can orchestrate the entire workflow through Claude Desktop.

This repository represents the first milestone toward building an autonomous AI publishing platform capable of generating publication-ready children's books with minimal manual intervention.

---

## Skills Demonstrated

This project showcases practical software engineering and AI workflow design skills, including:

* AI Agent Development
* Model Context Protocol (MCP)
* Claude Desktop Integration
* Node.js & JavaScript
* Prompt Engineering
* Workflow Automation
* State Management
* Technical Product Thinking
* Software Architecture
* Git & GitHub

---

## Roadmap

The long-term vision for this project includes:

* Modular story generation engine
* Illustration prompt generation
* Children's activity generation
* Poetry generation
* DOCX and PDF export
* Amazon KDP formatting
* Metadata generation
* Automated quality review
* Social media content generation
* End-to-end autonomous publishing pipeline

---

## Current Status

This project is actively under development.

The current version demonstrates a working MCP server integrated with Claude Desktop for AI-assisted children's book generation. Future iterations will focus on modular architecture, testing, enhanced exports, and a complete autonomous publishing workflow.

---

## License

This project is released under the MIT License.

```
```