@echoes-io/mcp-server 1.2.0 → 1.3.1

package/README.md

@@ -40,7 +40,7 @@ Then configure:
       "env": {
         "ECHOES_TIMELINE": "your-timeline-name",
         "ECHOES_RAG_PROVIDER": "e5-small",
-        "ECHOES_CHROMA_URL": "./rag_data"
+        "ECHOES_RAG_DB_PATH": "./rag_data.db"
       }
     }
   }
@@ -52,7 +52,7 @@ Then configure:
 **Optional RAG Configuration:**
 - `ECHOES_RAG_PROVIDER`: Embedding provider (`e5-small`, `e5-large`, or `gemini`). Default: `e5-small`
 - `ECHOES_GEMINI_API_KEY`: Required if using `gemini` provider
-- `ECHOES_CHROMA_URL`: ChromaDB storage path. Default: `./rag_data`
+- `ECHOES_RAG_DB_PATH`: SQLite database path. Default: `./rag_data.db`
 
 ## Available Tools
 
@@ -108,6 +108,13 @@ All tools operate on the timeline specified by the `ECHOES_TIMELINE` environment
   - Input: `query`, optional: `arc`, `pov`, `maxChapters`
   - Output: Full chapter content for AI context
 
+### Book Generation
+- **`book-generate`** - Generate PDF book from timeline content using LaTeX
+  - Input: `contentPath`, `outputPath`, optional: `episodes`, `format`
+  - Output: PDF book with Victoria Regia template
+  - Formats: `a4` (default), `a5`
+  - Requirements: pandoc, LaTeX distribution (pdflatex/xelatex/lualatex)
+
 ## Development
 
 ### Scripts
@@ -144,11 +151,6 @@ npm run lint:fix
 - **Testing**: Comprehensive unit and integration tests
 - **Environment**: Uses `ECHOES_TIMELINE` env var for timeline context
 
-## Roadmap
-
-### Planned Features
-- **Book generation** - LaTeX/PDF compilation tools for creating publishable books from timeline content
-
 ## License
 
 MIT

package/lib/server.js

@@ -7,7 +7,7 @@ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import { zodToJsonSchema } from 'zod-to-json-schema';
-import { chapterDelete, chapterDeleteSchema, chapterInfo, chapterInfoSchema, chapterInsert, chapterInsertSchema, chapterRefresh, chapterRefreshSchema, episodeInfo, episodeInfoSchema, episodeUpdate, episodeUpdateSchema, ragContext, ragContextSchema, ragIndex, ragIndexSchema, ragSearch, ragSearchSchema, stats, statsSchema, timelineSync, timelineSyncSchema, wordsCount, wordsCountSchema, } from './tools/index.js';
+import { bookGenerate, bookGenerateSchema, chapterDelete, chapterDeleteSchema, chapterInfo, chapterInfoSchema, chapterInsert, chapterInsertSchema, chapterRefresh, chapterRefreshSchema, episodeInfo, episodeInfoSchema, episodeUpdate, episodeUpdateSchema, ragContext, ragContextSchema, ragIndex, ragIndexSchema, ragSearch, ragSearchSchema, stats, statsSchema, timelineSync, timelineSyncSchema, wordsCount, wordsCountSchema, } from './tools/index.js';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));
 export function createServer(tracker, rag) {
@@ -82,6 +82,11 @@ export function createServer(tracker, rag) {
                     description: 'Retrieve relevant context for AI interactions',
                     inputSchema: zodToJsonSchema(ragContextSchema),
                 },
+                {
+                    name: 'book-generate',
+                    description: 'Generate PDF book from timeline content using LaTeX',
+                    inputSchema: zodToJsonSchema(bookGenerateSchema),
+                },
             ],
         };
     });
@@ -112,6 +117,8 @@ export function createServer(tracker, rag) {
                 return await ragSearch(ragSearchSchema.parse(args), rag);
             case 'rag-context':
                 return await ragContext(ragContextSchema.parse(args), rag);
+            case 'book-generate':
+                return await bookGenerate(bookGenerateSchema.parse(args));
             default:
                 throw new Error(`Unknown tool: ${name}`);
         }
@@ -125,14 +132,15 @@ export async function runServer() {
     await tracker.init();
     console.error(`Tracker database initialized: ${dbPath}`);
     // Initialize RAG system
-    const chromaUrl = process.env.ECHOES_CHROMA_URL || (process.env.NODE_ENV === 'test' ? ':memory:' : './rag_data');
+    const ragDbPath = process.env.ECHOES_RAG_DB_PATH ||
+        (process.env.NODE_ENV === 'test' ? ':memory:' : './rag_data.db');
     const provider = (process.env.ECHOES_RAG_PROVIDER || 'e5-small');
     const rag = new RAGSystem({
         provider,
-        chromaUrl,
+        dbPath: ragDbPath,
         geminiApiKey: process.env.ECHOES_GEMINI_API_KEY,
     });
-    console.error(`RAG system initialized: ${chromaUrl} (provider: ${provider})`);
+    console.error(`RAG system initialized: ${ragDbPath} (provider: ${provider})`);
     const server = createServer(tracker, rag);
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/lib/tools/book-generate.d.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+export declare const bookGenerateSchema: z.ZodObject<{
+    contentPath: z.ZodString;
+    outputPath: z.ZodString;
+    episodes: z.ZodOptional<z.ZodString>;
+    format: z.ZodOptional<z.ZodEnum<["a4", "a5"]>>;
+}, "strip", z.ZodTypeAny, {
+    contentPath: string;
+    outputPath: string;
+    episodes?: string | undefined;
+    format?: "a4" | "a5" | undefined;
+}, {
+    contentPath: string;
+    outputPath: string;
+    episodes?: string | undefined;
+    format?: "a4" | "a5" | undefined;
+}>;
+export declare function bookGenerate(args: z.infer<typeof bookGenerateSchema>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/lib/tools/book-generate.js

@@ -0,0 +1,38 @@
+import { generateBook } from '@echoes-io/books-generator';
+import { z } from 'zod';
+import { getTimeline } from '../utils.js';
+export const bookGenerateSchema = z.object({
+    contentPath: z.string().describe('Path to timeline content folder'),
+    outputPath: z.string().describe('Output PDF file path'),
+    episodes: z.string().optional().describe('Comma-separated episode numbers (e.g., "1,2,3")'),
+    format: z.enum(['a4', 'a5']).optional().describe('Page format (default: a4)'),
+});
+export async function bookGenerate(args) {
+    try {
+        const timeline = getTimeline();
+        await generateBook({
+            contentPath: args.contentPath,
+            outputPath: args.outputPath,
+            timeline,
+            episodes: args.episodes,
+            format: args.format || 'a4',
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        timeline,
+                        outputPath: args.outputPath,
+                        episodes: args.episodes || 'all',
+                        format: args.format || 'a4',
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to generate book: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}

package/lib/tools/index.d.ts

@@ -1,3 +1,4 @@
+export { bookGenerate, bookGenerateSchema } from './book-generate.js';
 export { chapterDelete, chapterDeleteSchema } from './chapter-delete.js';
 export { chapterInfo, chapterInfoSchema } from './chapter-info.js';
 export { chapterInsert, chapterInsertSchema } from './chapter-insert.js';

package/lib/tools/index.js

@@ -1,3 +1,4 @@
+export { bookGenerate, bookGenerateSchema } from './book-generate.js';
 export { chapterDelete, chapterDeleteSchema } from './chapter-delete.js';
 export { chapterInfo, chapterInfoSchema } from './chapter-info.js';
 export { chapterInsert, chapterInsertSchema } from './chapter-insert.js';

package/lib/tools/rag-search.js

@@ -35,7 +35,7 @@ export async function ragSearch(args, rag) {
                                 title: r.metadata.title,
                             },
                             similarity: r.similarity,
-                            preview: r.content.substring(0, 200) + '...',
+                            preview: `${r.content.substring(0, 200)}...`,
                         })),
                     }, null, 2),
                 },

package/lib/tools/timeline-sync.js

@@ -1,4 +1,4 @@
-import { existsSync, readdirSync } from 'node:fs';
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
 import { extname, join } from 'node:path';
 import { getTextStats, parseMarkdown } from '@echoes-io/utils';
 import { z } from 'zod';
@@ -43,22 +43,29 @@ export async function timelineSync(args, tracker) {
                 const episodePath = join(arcPath, ep.name);
                 let episode = await tracker.getEpisode(timeline, arcName, ep.number);
                 if (!episode) {
-                    episode = await tracker.createEpisode({
-                        timelineName: timeline,
-                        arcName: arcName,
-                        number: ep.number,
-                        slug: ep.name,
-                        title: ep.name,
-                        description: `Episode ${ep.number}`,
-                    });
-                    added++;
+                    try {
+                        episode = await tracker.createEpisode({
+                            timelineName: timeline,
+                            arcName: arcName,
+                            number: ep.number,
+                            slug: ep.name,
+                            title: ep.name,
+                            description: `Episode ${ep.number}`,
+                        });
+                        added++;
+                    }
+                    catch (error) {
+                        console.error(`Error creating episode ${arcName}/ep${ep.number}:`, error instanceof Error ? error.message : error);
+                        errors++;
+                        continue; // Skip chapters if episode creation failed
+                    }
                 }
                 const chapters = readdirSync(episodePath)
                     .filter((file) => extname(file) === '.md')
                     .map((file) => {
                     try {
                         const filePath = join(episodePath, file);
-                        const content = require('node:fs').readFileSync(filePath, 'utf-8');
+                        const content = readFileSync(filePath, 'utf-8');
                         const { metadata, content: markdownContent } = parseMarkdown(content);
                         const stats = getTextStats(markdownContent);
                         return {
@@ -73,6 +80,30 @@ export async function timelineSync(args, tracker) {
                     }
                 })
                     .filter((ch) => ch !== null);
+                // Collect unique part numbers
+                const partNumbers = new Set(chapters.map((ch) => ch?.metadata.part || 1));
+                // Create parts if they don't exist
+                for (const partNum of partNumbers) {
+                    try {
+                        const existingPart = await tracker.getPart(timeline, arcName, ep.number, partNum);
+                        if (!existingPart) {
+                            await tracker.createPart({
+                                timelineName: timeline,
+                                arcName: arcName,
+                                episodeNumber: ep.number,
+                                number: partNum,
+                                slug: `part-${partNum}`,
+                                title: `Part ${partNum}`,
+                                description: `Part ${partNum} of Episode ${ep.number}`,
+                            });
+                            added++;
+                        }
+                    }
+                    catch (error) {
+                        console.error(`Error creating part ${arcName}/ep${ep.number}/part${partNum}:`, error instanceof Error ? error.message : error);
+                        errors++;
+                    }
+                }
                 for (const chapterData of chapters) {
                     if (!chapterData)
                         continue;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@echoes-io/mcp-server",
   "type": "module",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "description": "Model Context Protocol server for AI integration with Echoes storytelling platform",
   "scripts": {
     "dev": "tsx cli/index.ts",
@@ -81,8 +81,9 @@
     "vitest": "^3.2.4"
   },
   "dependencies": {
+    "@echoes-io/books-generator": "^1.0.0",
     "@echoes-io/models": "^1.0.0",
-    "@echoes-io/rag": "^1.0.0",
+    "@echoes-io/rag": "^1.1.0",
     "@echoes-io/tracker": "^1.0.0",
     "@echoes-io/utils": "^1.1.1",
     "@modelcontextprotocol/sdk": "^1.0.0"