@echoes-io/mcp-server 1.2.0 → 1.3.0

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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@echoes-io/mcp-server",
   "type": "module",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "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"