recker 1.0.11-alpha.d342d95 → 1.0.11-alpha.e84cc95

package/dist/cli/index.js

@@ -329,13 +329,20 @@ ${pc.bold(pc.yellow('Examples:'))}
     program
         .command('mcp')
         .description('Start MCP server for AI agents to access Recker documentation')
-        .option('-p, --port <number>', 'Server port', '3100')
+        .option('-t, --transport <mode>', 'Transport mode: stdio, http, sse', 'stdio')
+        .option('-p, --port <number>', 'Server port (for http/sse modes)', '3100')
         .option('-d, --docs <path>', 'Path to documentation folder')
         .option('--debug', 'Enable debug logging')
         .addHelpText('after', `
+${pc.bold(pc.yellow('Transport Modes:'))}
+  ${pc.cyan('stdio')}  ${pc.gray('(default)')} For Claude Code and other CLI tools
+  ${pc.cyan('http')}   Simple HTTP POST endpoint
+  ${pc.cyan('sse')}    HTTP + Server-Sent Events for real-time notifications
+
 ${pc.bold(pc.yellow('Usage:'))}
-  ${pc.green('$ rek mcp')}                    ${pc.gray('Start server on port 3100')}
-  ${pc.green('$ rek mcp -p 8080')}            ${pc.gray('Start on custom port')}
+  ${pc.green('$ rek mcp')}                    ${pc.gray('Start in stdio mode (for Claude Code)')}
+  ${pc.green('$ rek mcp -t http')}            ${pc.gray('Start HTTP server on port 3100')}
+  ${pc.green('$ rek mcp -t sse -p 8080')}     ${pc.gray('Start SSE server on custom port')}
   ${pc.green('$ rek mcp --debug')}            ${pc.gray('Enable debug logging')}
 
 ${pc.bold(pc.yellow('Tools provided:'))}
@@ -354,19 +361,34 @@ ${pc.bold(pc.yellow('Claude Code config (~/.claude.json):'))}
 `)
         .action(async (options) => {
         const { MCPServer } = await import('../mcp/server.js');
+        const transport = options.transport;
         const server = new MCPServer({
+            transport,
             port: parseInt(options.port),
             docsPath: options.docs,
             debug: options.debug,
         });
+        if (transport === 'stdio') {
+            await server.start();
+            return;
+        }
         await server.start();
+        const endpoints = transport === 'sse'
+            ? `
+│  POST /        - JSON-RPC endpoint          │
+│  GET  /sse     - Server-Sent Events         │
+│  GET  /health  - Health check               │`
+            : `
+│  POST /        - JSON-RPC endpoint          │`;
         console.log(pc.green(`
 ┌─────────────────────────────────────────────┐
 │  ${pc.bold('Recker MCP Server')}                         │
 ├─────────────────────────────────────────────┤
-│  Endpoint: ${pc.cyan(`http://localhost:${options.port}`)}         │
+│  Transport: ${pc.cyan(transport.padEnd(31))}│
+│  Endpoint: ${pc.cyan(`http://localhost:${options.port}`.padEnd(32))}│
 │  Docs indexed: ${pc.yellow(String(server.getDocsCount()).padEnd(28))}│
-│                                             │
+├─────────────────────────────────────────────┤${endpoints}
+├─────────────────────────────────────────────┤
 │  Tools:                                     │
 │    • ${pc.cyan('search_docs')} - Search documentation     │
 │    • ${pc.cyan('get_doc')}     - Get full doc content     │

package/dist/mcp/server.d.ts

@@ -1,15 +1,21 @@
+import type { JsonRpcRequest, JsonRpcResponse } from './types.js';
+export type MCPTransportMode = 'stdio' | 'http' | 'sse';
 export interface MCPServerOptions {
     name?: string;
     version?: string;
     docsPath?: string;
     port?: number;
+    transport?: MCPTransportMode;
     debug?: boolean;
 }
 export declare class MCPServer {
     private options;
     private server?;
     private docsIndex;
+    private sseClients;
+    private initialized;
     constructor(options?: MCPServerOptions);
+    private log;
     private findDocsPath;
     private buildIndex;
     private walkDir;
@@ -20,11 +26,16 @@ export declare class MCPServer {
     private searchDocs;
     private extractSnippet;
     private getDoc;
-    private handleRequest;
+    handleRequest(req: JsonRpcRequest): JsonRpcResponse;
+    private sendNotification;
+    private startStdio;
+    private startHttp;
+    private startSSE;
     start(): Promise<void>;
     stop(): Promise<void>;
     getPort(): number;
     getDocsCount(): number;
+    getTransport(): MCPTransportMode;
 }
 export declare function createMCPServer(options?: MCPServerOptions): MCPServer;
 //# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAiBD,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,MAAM,CAAC,CAAkC;IACjD,OAAO,CAAC,SAAS,CAAkB;gBAEvB,OAAO,GAAE,gBAAqB;IAY1C,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,UAAU;IAuClB,OAAO,CAAC,OAAO;IAyBf,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,eAAe;IAyBvB,OAAO,CAAC,QAAQ;IAyChB,OAAO,CAAC,cAAc;IActB,OAAO,CAAC,UAAU;IA4DlB,OAAO,CAAC,cAAc;IAoBtB,OAAO,CAAC,MAAM;IAmCd,OAAO,CAAC,aAAa;IAiDf,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA4DtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3B,OAAO,IAAI,MAAM;IAIjB,YAAY,IAAI,MAAM;CAGvB;AAKD,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAErE"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAMhB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;AAExD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAsBD,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,MAAM,CAAC,CAAkC;IACjD,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,GAAE,gBAAqB;IAa1C,OAAO,CAAC,GAAG;IAWX,OAAO,CAAC,YAAY;IAuBpB,OAAO,CAAC,UAAU;IAiClB,OAAO,CAAC,OAAO;IAyBf,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,eAAe;IAqBvB,OAAO,CAAC,QAAQ;IAyChB,OAAO,CAAC,cAAc;IActB,OAAO,CAAC,UAAU;IA2DlB,OAAO,CAAC,cAAc;IAmBtB,OAAO,CAAC,MAAM;IAmCd,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,eAAe;IAkEnD,OAAO,CAAC,gBAAgB;YAUV,UAAU;YAqCV,SAAS;YAkDT,QAAQ;IA2FhB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAatB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB3B,OAAO,IAAI,MAAM;IAIjB,YAAY,IAAI,MAAM;IAItB,YAAY,IAAI,gBAAgB;CAGjC;AAoBD,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAErE"}

package/dist/mcp/server.js

@@ -1,27 +1,42 @@
 import { createServer } from 'http';
 import { readFileSync, readdirSync, statSync, existsSync } from 'fs';
 import { join, relative } from 'path';
+import { createInterface } from 'readline';
 export class MCPServer {
     options;
     server;
     docsIndex = [];
+    sseClients = new Set();
+    initialized = false;
     constructor(options = {}) {
         this.options = {
             name: options.name || 'recker-docs',
             version: options.version || '1.0.0',
             docsPath: options.docsPath || this.findDocsPath(),
             port: options.port || 3100,
+            transport: options.transport || 'stdio',
             debug: options.debug || false,
         };
         this.buildIndex();
     }
+    log(message, data) {
+        if (this.options.debug) {
+            if (this.options.transport === 'stdio') {
+                console.error(`[MCP] ${message}`, data ? JSON.stringify(data) : '');
+            }
+            else {
+                console.log(`[MCP] ${message}`, data ? JSON.stringify(data) : '');
+            }
+        }
+    }
     findDocsPath() {
         const possiblePaths = [
             join(process.cwd(), 'docs'),
             join(process.cwd(), '..', 'docs'),
-            join(__dirname, '..', '..', 'docs'),
-            join(__dirname, '..', '..', '..', 'docs'),
         ];
+        if (typeof __dirname !== 'undefined') {
+            possiblePaths.push(join(__dirname, '..', '..', 'docs'), join(__dirname, '..', '..', '..', 'docs'));
+        }
         for (const p of possiblePaths) {
             if (existsSync(p)) {
                 return p;
@@ -31,9 +46,7 @@ export class MCPServer {
     }
     buildIndex() {
         if (!existsSync(this.options.docsPath)) {
-            if (this.options.debug) {
-                console.log(`[MCP] Docs path not found: ${this.options.docsPath}`);
-            }
+            this.log(`Docs path not found: ${this.options.docsPath}`);
             return;
         }
         const files = this.walkDir(this.options.docsPath);
@@ -55,14 +68,10 @@ export class MCPServer {
                 });
             }
             catch (err) {
-                if (this.options.debug) {
-                    console.log(`[MCP] Failed to index ${file}:`, err);
-                }
+                this.log(`Failed to index ${file}:`, err);
             }
         }
-        if (this.options.debug) {
-            console.log(`[MCP] Indexed ${this.docsIndex.length} documentation files`);
-        }
+        this.log(`Indexed ${this.docsIndex.length} documentation files`);
     }
     walkDir(dir) {
         const files = [];
@@ -255,9 +264,11 @@ export class MCPServer {
     }
     handleRequest(req) {
         const { method, params, id } = req;
+        this.log(`Request: ${method}`, params);
         try {
             switch (method) {
                 case 'initialize': {
+                    this.initialized = true;
                     const response = {
                         protocolVersion: '2024-11-05',
                         capabilities: {
@@ -270,6 +281,9 @@ export class MCPServer {
                     };
                     return { jsonrpc: '2.0', id: id, result: response };
                 }
+                case 'notifications/initialized': {
+                    return { jsonrpc: '2.0', id: id, result: {} };
+                }
                 case 'ping':
                     return { jsonrpc: '2.0', id: id, result: {} };
                 case 'tools/list': {
@@ -281,6 +295,10 @@ export class MCPServer {
                     const result = this.handleToolCall(name, args || {});
                     return { jsonrpc: '2.0', id: id, result };
                 }
+                case 'resources/list':
+                    return { jsonrpc: '2.0', id: id, result: { resources: [] } };
+                case 'prompts/list':
+                    return { jsonrpc: '2.0', id: id, result: { prompts: [] } };
                 default:
                     return {
                         jsonrpc: '2.0',
@@ -297,11 +315,46 @@ export class MCPServer {
             };
         }
     }
-    async start() {
+    sendNotification(notification) {
+        const data = JSON.stringify(notification);
+        for (const client of this.sseClients) {
+            client.write(`data: ${data}\n\n`);
+        }
+    }
+    async startStdio() {
+        const rl = createInterface({
+            input: process.stdin,
+            output: process.stdout,
+            terminal: false,
+        });
+        this.log('Starting in stdio mode');
+        rl.on('line', (line) => {
+            if (!line.trim())
+                return;
+            try {
+                const request = JSON.parse(line);
+                const response = this.handleRequest(request);
+                process.stdout.write(JSON.stringify(response) + '\n');
+            }
+            catch (err) {
+                const errorResponse = {
+                    jsonrpc: '2.0',
+                    id: 0,
+                    error: { code: -32700, message: 'Parse error' },
+                };
+                process.stdout.write(JSON.stringify(errorResponse) + '\n');
+            }
+        });
+        rl.on('close', () => {
+            this.log('stdin closed, exiting');
+            process.exit(0);
+        });
+    }
+    async startHttp() {
         return new Promise((resolve) => {
             this.server = createServer((req, res) => {
                 res.setHeader('Access-Control-Allow-Origin', '*');
-                res.setHeader('Access-Control-Allow-Methods', 'POST, OPTIONS');
+                res.setHeader('Access-Control-Allow-Methods', 'POST, GET, OPTIONS');
                 res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
                 if (req.method === 'OPTIONS') {
                     res.writeHead(204);
@@ -318,13 +371,7 @@ export class MCPServer {
                 req.on('end', () => {
                     try {
                         const request = JSON.parse(body);
-                        if (this.options.debug) {
-                            console.log('[MCP] Request:', JSON.stringify(request, null, 2));
-                        }
                         const response = this.handleRequest(request);
-                        if (this.options.debug) {
-                            console.log('[MCP] Response:', JSON.stringify(response, null, 2));
-                        }
                         res.writeHead(200, { 'Content-Type': 'application/json' });
                         res.end(JSON.stringify(response));
                     }
@@ -339,16 +386,99 @@ export class MCPServer {
                 });
             });
             this.server.listen(this.options.port, () => {
-                if (this.options.debug) {
-                    console.log(`[MCP] Server listening on http://localhost:${this.options.port}`);
-                    console.log(`[MCP] Docs path: ${this.options.docsPath}`);
-                    console.log(`[MCP] Indexed ${this.docsIndex.length} files`);
+                this.log(`HTTP server listening on http://localhost:${this.options.port}`);
+                resolve();
+            });
+        });
+    }
+    async startSSE() {
+        return new Promise((resolve) => {
+            this.server = createServer((req, res) => {
+                res.setHeader('Access-Control-Allow-Origin', '*');
+                res.setHeader('Access-Control-Allow-Methods', 'POST, GET, OPTIONS');
+                res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
+                const url = req.url || '/';
+                if (req.method === 'OPTIONS') {
+                    res.writeHead(204);
+                    res.end();
+                    return;
                 }
+                if (req.method === 'GET' && url === '/sse') {
+                    res.writeHead(200, {
+                        'Content-Type': 'text/event-stream',
+                        'Cache-Control': 'no-cache',
+                        'Connection': 'keep-alive',
+                    });
+                    res.write(`data: ${JSON.stringify({ type: 'connected' })}\n\n`);
+                    this.sseClients.add(res);
+                    this.log(`SSE client connected (${this.sseClients.size} total)`);
+                    req.on('close', () => {
+                        this.sseClients.delete(res);
+                        this.log(`SSE client disconnected (${this.sseClients.size} total)`);
+                    });
+                    return;
+                }
+                if (req.method === 'POST') {
+                    let body = '';
+                    req.on('data', chunk => body += chunk);
+                    req.on('end', () => {
+                        try {
+                            const request = JSON.parse(body);
+                            const response = this.handleRequest(request);
+                            res.writeHead(200, { 'Content-Type': 'application/json' });
+                            res.end(JSON.stringify(response));
+                        }
+                        catch (err) {
+                            res.writeHead(400, { 'Content-Type': 'application/json' });
+                            res.end(JSON.stringify({
+                                jsonrpc: '2.0',
+                                id: null,
+                                error: { code: -32700, message: 'Parse error' },
+                            }));
+                        }
+                    });
+                    return;
+                }
+                if (req.method === 'GET' && url === '/health') {
+                    res.writeHead(200, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({
+                        status: 'ok',
+                        name: this.options.name,
+                        version: this.options.version,
+                        docsCount: this.docsIndex.length,
+                        sseClients: this.sseClients.size,
+                    }));
+                    return;
+                }
+                res.writeHead(404);
+                res.end('Not found');
+            });
+            this.server.listen(this.options.port, () => {
+                this.log(`SSE server listening on http://localhost:${this.options.port}`);
+                this.log(`  POST /        - JSON-RPC endpoint`);
+                this.log(`  GET  /sse     - Server-Sent Events`);
+                this.log(`  GET  /health  - Health check`);
                 resolve();
             });
         });
     }
+    async start() {
+        switch (this.options.transport) {
+            case 'stdio':
+                return this.startStdio();
+            case 'http':
+                return this.startHttp();
+            case 'sse':
+                return this.startSSE();
+            default:
+                throw new Error(`Unknown transport: ${this.options.transport}`);
+        }
+    }
     async stop() {
+        for (const client of this.sseClients) {
+            client.end();
+        }
+        this.sseClients.clear();
         return new Promise((resolve) => {
             if (this.server) {
                 this.server.close(() => resolve());
@@ -364,6 +494,9 @@ export class MCPServer {
     getDocsCount() {
         return this.docsIndex.length;
     }
+    getTransport() {
+        return this.options.transport;
+    }
 }
 export function createMCPServer(options) {
     return new MCPServer(options);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "recker",
-  "version": "1.0.11-alpha.d342d95",
+  "version": "1.0.11-alpha.e84cc95",
   "description": "AI & DevX focused HTTP client for Node.js 18+",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",