xhs-mcp 0.6.0

package/dist/server/handlers/tool.handlers.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Tool request handlers for XHS MCP Server
+ */
+export declare class ToolHandlers {
+    private authService;
+    private feedService;
+    private publishService;
+    constructor();
+    handleAuthLogin(browserPath?: string): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+    handleAuthLogout(): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+    handleAuthStatus(browserPath?: string): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+    handleDiscoverFeeds(browserPath?: string): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+    handleSearchNote(keyword?: string, browserPath?: string): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+    handleGetNoteDetail(feedId?: string, xsecToken?: string, browserPath?: string): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+    handleCommentOnNote(feedId?: string, xsecToken?: string, note?: string, browserPath?: string): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+    handlePublishContent(type?: string, title?: string, content?: string, mediaPaths?: string[], tags?: string, browserPath?: string): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+    handleToolRequest(name: string, args: any): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+}
+//# sourceMappingURL=tool.handlers.d.ts.map

package/dist/server/handlers/tool.handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.handlers.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/tool.handlers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,cAAc,CAAiB;;IASjC,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IA6BlG,gBAAgB,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAK/E,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAMnG,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAKtG,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAMrH,mBAAmB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAM3I,mBAAmB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAO1J,oBAAoB,CACxB,IAAI,CAAC,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EAAE,EACrB,IAAI,CAAC,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IA6BxD,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;CA8C9G"}

package/dist/server/handlers/tool.handlers.js

@@ -0,0 +1,123 @@
+/**
+ * Tool request handlers for XHS MCP Server
+ */
+import { AuthService } from '../../lib/auth/auth.service.js';
+import { FeedService } from '../../lib/feeds/feed.service.js';
+import { PublishService } from '../../lib/publishing/publish.service.js';
+import { getConfig } from '../../lib/shared/config.js';
+import { XHSError } from '../../lib/shared/errors.js';
+import { validateRequiredParams, safeErrorHandler, createToolResponse, createErrorResponse } from '../../lib/shared/utils.js';
+import { logger } from '../../lib/shared/logger.js';
+export class ToolHandlers {
+    authService;
+    feedService;
+    publishService;
+    constructor() {
+        const config = getConfig();
+        this.authService = new AuthService(config);
+        this.feedService = new FeedService(config);
+        this.publishService = new PublishService(config);
+    }
+    async handleAuthLogin(browserPath) {
+        // Start login process in background and return immediately
+        // This follows the "instant response" pattern described in README
+        this.authService.login(browserPath).catch(error => {
+            safeErrorHandler(error, 'Background login error', logger);
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        message: 'Login process started. A browser window will open for you to complete the login.',
+                        status: 'login_started',
+                        action: 'browser_opened',
+                        instructions: [
+                            '1. Complete the login process in the opened browser window',
+                            '2. Scan QR code or enter your credentials',
+                            '3. Login will be automatically verified and cookies saved',
+                            '4. Use xhs_auth_status to check if login completed'
+                        ],
+                        note: 'The login process runs in the background. You can continue using other tools while login completes.'
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    async handleAuthLogout() {
+        const result = await this.authService.logout();
+        return createToolResponse(result);
+    }
+    async handleAuthStatus(browserPath) {
+        const result = await this.authService.checkStatus(browserPath);
+        return createToolResponse(result);
+    }
+    async handleDiscoverFeeds(browserPath) {
+        const result = await this.feedService.getFeedList(browserPath);
+        return createToolResponse(result);
+    }
+    async handleSearchNote(keyword, browserPath) {
+        validateRequiredParams({ keyword }, ['keyword']);
+        const result = await this.feedService.searchFeeds(keyword, browserPath);
+        return createToolResponse(result);
+    }
+    async handleGetNoteDetail(feedId, xsecToken, browserPath) {
+        validateRequiredParams({ feedId, xsecToken }, ['feedId', 'xsecToken']);
+        const result = await this.feedService.getFeedDetail(feedId, xsecToken, browserPath);
+        return createToolResponse(result);
+    }
+    async handleCommentOnNote(feedId, xsecToken, note, browserPath) {
+        validateRequiredParams({ feedId, xsecToken, note }, ['feedId', 'xsecToken', 'note']);
+        const result = await this.feedService.commentOnFeed(feedId, xsecToken, note, browserPath);
+        return createToolResponse(result);
+    }
+    async handlePublishContent(type, title, content, mediaPaths, tags, browserPath) {
+        validateRequiredParams({ type, title, content, mediaPaths }, ['type', 'title', 'content', 'mediaPaths']);
+        // Validate content type
+        if (type !== 'image' && type !== 'video') {
+            throw new Error('Content type must be "image" or "video"');
+        }
+        // Validate parameter constraints
+        if (title.length > 20) {
+            throw new Error('Title must be 20 characters or less');
+        }
+        if (content.length > 1000) {
+            throw new Error('Content must be 1000 characters or less');
+        }
+        // Execute unified publishing process
+        const result = await this.publishService.publishContent(type, title, content, mediaPaths, tags, browserPath);
+        return createToolResponse(result);
+    }
+    async handleToolRequest(name, args) {
+        try {
+            switch (name) {
+                case 'xhs_auth_login':
+                    return await this.handleAuthLogin(args?.browser_path);
+                case 'xhs_auth_logout':
+                    return await this.handleAuthLogout();
+                case 'xhs_auth_status':
+                    return await this.handleAuthStatus(args?.browser_path);
+                case 'xhs_discover_feeds':
+                    return await this.handleDiscoverFeeds(args?.browser_path);
+                case 'xhs_search_note':
+                    return await this.handleSearchNote(args?.keyword, args?.browser_path);
+                case 'xhs_get_note_detail':
+                    return await this.handleGetNoteDetail(args?.feed_id, args?.xsec_token, args?.browser_path);
+                case 'xhs_comment_on_note':
+                    return await this.handleCommentOnNote(args?.feed_id, args?.xsec_token, args?.note, args?.browser_path);
+                case 'xhs_publish_content':
+                    return await this.handlePublishContent(args?.type, args?.title, args?.content, args?.media_paths, args?.tags, args?.browser_path);
+                default:
+                    throw new Error(`Unknown tool: ${name}`);
+            }
+        }
+        catch (error) {
+            if (error instanceof XHSError) {
+                return createToolResponse(error.toDict());
+            }
+            return createErrorResponse(error);
+        }
+    }
+}
+//# sourceMappingURL=tool.handlers.js.map

package/dist/server/handlers/tool.handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.handlers.js","sourceRoot":"","sources":["../../../src/server/handlers/tool.handlers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAA6B,gBAAgB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACzJ,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEpD,MAAM,OAAO,YAAY;IACf,WAAW,CAAc;IACzB,WAAW,CAAc;IACzB,cAAc,CAAiB;IAEvC;QACE,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,CAAC,cAAc,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,WAAoB;QACxC,2DAA2D;QAC3D,kEAAkE;QAClE,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;YAChD,gBAAgB,CAAC,KAAK,EAAE,wBAAwB,EAAE,MAAM,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,OAAO,EAAE,IAAI;wBACb,OAAO,EAAE,kFAAkF;wBAC3F,MAAM,EAAE,eAAe;wBACvB,MAAM,EAAE,gBAAgB;wBACxB,YAAY,EAAE;4BACZ,4DAA4D;4BAC5D,2CAA2C;4BAC3C,2DAA2D;4BAC3D,oDAAoD;yBACrD;wBACD,IAAI,EAAE,qGAAqG;qBAC5G,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ;aACF;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;QAC/C,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,WAAoB;QACzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAC/D,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAGD,KAAK,CAAC,mBAAmB,CAAC,WAAoB;QAC5C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAC/D,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,OAAgB,EAAE,WAAoB;QAC3D,sBAAsB,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,OAAQ,EAAE,WAAW,CAAC,CAAC;QACzE,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,MAAe,EAAE,SAAkB,EAAE,WAAoB;QACjF,sBAAsB,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;QACvE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,MAAO,EAAE,SAAU,EAAE,WAAW,CAAC,CAAC;QACtF,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,MAAe,EAAE,SAAkB,EAAE,IAAa,EAAE,WAAoB;QAChG,sBAAsB,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;QACrF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,MAAO,EAAE,SAAU,EAAE,IAAK,EAAE,WAAW,CAAC,CAAC;QAC7F,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAGD,KAAK,CAAC,oBAAoB,CACxB,IAAa,EACb,KAAc,EACd,OAAgB,EAChB,UAAqB,EACrB,IAAa,EACb,WAAoB;QAEpB,sBAAsB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;QAEzG,wBAAwB;QACxB,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QAED,iCAAiC;QACjC,IAAI,KAAM,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,OAAQ,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QAED,qCAAqC;QACrC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,cAAc,CACrD,IAAyB,EACzB,KAAM,EACN,OAAQ,EACR,UAAW,EACX,IAAI,EACJ,WAAW,CACZ,CAAC;QACF,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAGD,KAAK,CAAC,iBAAiB,CAAC,IAAY,EAAE,IAAS;QAC7C,IAAI,CAAC;YACH,QAAQ,IAAI,EAAE,CAAC;gBACb,KAAK,gBAAgB;oBACnB,OAAO,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,YAAsB,CAAC,CAAC;gBAElE,KAAK,iBAAiB;oBACpB,OAAO,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBAEvC,KAAK,iBAAiB;oBACpB,OAAO,MAAM,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,YAAsB,CAAC,CAAC;gBAGnE,KAAK,oBAAoB;oBACvB,OAAO,MAAM,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,YAAsB,CAAC,CAAC;gBAEtE,KAAK,iBAAiB;oBACpB,OAAO,MAAM,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAiB,EAAE,IAAI,EAAE,YAAsB,CAAC,CAAC;gBAE5F,KAAK,qBAAqB;oBACxB,OAAO,MAAM,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,OAAiB,EAAE,IAAI,EAAE,UAAoB,EAAE,IAAI,EAAE,YAAsB,CAAC,CAAC;gBAE3H,KAAK,qBAAqB;oBACxB,OAAO,MAAM,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,OAAiB,EAAE,IAAI,EAAE,UAAoB,EAAE,IAAI,EAAE,IAAc,EAAE,IAAI,EAAE,YAAsB,CAAC,CAAC;gBAEjJ,KAAK,qBAAqB;oBACxB,OAAO,MAAM,IAAI,CAAC,oBAAoB,CACpC,IAAI,EAAE,IAAc,EACpB,IAAI,EAAE,KAAe,EACrB,IAAI,EAAE,OAAiB,EACvB,IAAI,EAAE,WAAuB,EAC7B,IAAI,EAAE,IAAc,EACpB,IAAI,EAAE,YAAsB,CAC7B,CAAC;gBAGJ;oBACE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;gBAC9B,OAAO,kBAAkB,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YAC5C,CAAC;YACD,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;CACF"}

package/dist/server/http.server.d.ts

@@ -0,0 +1,21 @@
+/**
+ * HTTP Server with SSE and Streamable HTTP Transport Support
+ */
+export declare class XHSHTTPMCPServer {
+    private app;
+    private config;
+    private toolHandlers;
+    private resourceHandlers;
+    private transports;
+    private port;
+    constructor(port?: number);
+    private setupMiddleware;
+    private setupRoutes;
+    private handleStreamableHTTP;
+    private handleSSEConnection;
+    private handleSSEMessage;
+    private createMCPServer;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=http.server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.server.d.ts","sourceRoot":"","sources":["../../src/server/http.server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAoBH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,GAAG,CAAsB;IACjC,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,UAAU,CAA8E;IAChG,OAAO,CAAC,IAAI,CAAS;gBAET,IAAI,GAAE,MAAa;IAW/B,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,WAAW;YAmBL,oBAAoB;YA+EpB,mBAAmB;YA4BnB,gBAAgB;IAkC9B,OAAO,CAAC,eAAe;IAyCjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiFtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAW5B"}

package/dist/server/http.server.js

@@ -0,0 +1,310 @@
+/**
+ * HTTP Server with SSE and Streamable HTTP Transport Support
+ */
+import express from 'express';
+import cors from 'cors';
+import { randomUUID } from 'node:crypto';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { isInitializeRequest } from '@modelcontextprotocol/sdk/types.js';
+import { getConfig } from '../lib/shared/config.js';
+import { ToolHandlers } from './handlers/tool.handlers.js';
+import { ResourceHandlers } from './handlers/resource.handlers.js';
+import { XHS_TOOL_SCHEMAS, XHS_RESOURCE_SCHEMAS } from './schemas/tool.schemas.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+export class XHSHTTPMCPServer {
+    app;
+    config;
+    toolHandlers;
+    resourceHandlers;
+    transports = new Map();
+    port;
+    constructor(port = 3000) {
+        this.port = port;
+        this.config = getConfig();
+        this.toolHandlers = new ToolHandlers();
+        this.resourceHandlers = new ResourceHandlers();
+        this.app = express();
+        this.setupMiddleware();
+        this.setupRoutes();
+    }
+    setupMiddleware() {
+        // Parse JSON bodies
+        this.app.use(express.json());
+        // Configure CORS to expose Mcp-Session-Id header for browser-based clients
+        this.app.use(cors({
+            origin: '*', // Allow all origins - adjust as needed for production
+            exposedHeaders: ['Mcp-Session-Id']
+        }));
+    }
+    setupRoutes() {
+        // Streamable HTTP Transport (Protocol version 2025-03-26)
+        this.app.all('/mcp', this.handleStreamableHTTP.bind(this));
+        // Deprecated HTTP+SSE Transport (Protocol version 2024-11-05)
+        this.app.get('/sse', this.handleSSEConnection.bind(this));
+        this.app.post('/messages', this.handleSSEMessage.bind(this));
+        // Health check endpoint
+        this.app.get('/health', (req, res) => {
+            res.json({
+                status: 'healthy',
+                server: this.config.server.name,
+                version: this.config.server.version,
+                transports: ['streamable-http', 'sse']
+            });
+        });
+    }
+    async handleStreamableHTTP(req, res) {
+        console.log(`Received ${req.method} request to /mcp`);
+        try {
+            // Check for existing session ID
+            const sessionId = req.headers['mcp-session-id'];
+            let transport;
+            if (sessionId && this.transports.has(sessionId)) {
+                const existingTransport = this.transports.get(sessionId);
+                if (existingTransport instanceof StreamableHTTPServerTransport) {
+                    transport = existingTransport;
+                }
+                else {
+                    res.status(400).json({
+                        jsonrpc: '2.0',
+                        error: {
+                            code: -32000,
+                            message: 'Bad Request: Session exists but uses a different transport protocol',
+                        },
+                        id: null,
+                    });
+                    return;
+                }
+            }
+            else if (!sessionId && req.method === 'POST' && isInitializeRequest(req.body)) {
+                // Create new Streamable HTTP transport
+                transport = new StreamableHTTPServerTransport({
+                    sessionIdGenerator: () => randomUUID(),
+                    onsessioninitialized: (sessionId) => {
+                        console.log(`StreamableHTTP session initialized with ID: ${sessionId}`);
+                        this.transports.set(sessionId, transport);
+                    },
+                    onsessionclosed: (sessionId) => {
+                        console.log(`StreamableHTTP session closed: ${sessionId}`);
+                        this.transports.delete(sessionId);
+                    }
+                });
+                // Set up onclose handler to clean up transport when closed
+                transport.onclose = () => {
+                    const sid = transport.sessionId;
+                    if (sid && this.transports.has(sid)) {
+                        console.log(`Transport closed for session ${sid}, removing from transports map`);
+                        this.transports.delete(sid);
+                    }
+                };
+                // Connect the transport to the MCP server
+                const server = this.createMCPServer();
+                await server.connect(transport);
+            }
+            else {
+                // Invalid request - no session ID or not initialization request
+                res.status(400).json({
+                    jsonrpc: '2.0',
+                    error: {
+                        code: -32000,
+                        message: 'Bad Request: No valid session ID provided',
+                    },
+                    id: null,
+                });
+                return;
+            }
+            // Handle the request with the transport
+            await transport.handleRequest(req, res, req.body);
+        }
+        catch (error) {
+            console.error('Error handling Streamable HTTP request:', error);
+            if (!res.headersSent) {
+                res.status(500).json({
+                    jsonrpc: '2.0',
+                    error: {
+                        code: -32603,
+                        message: 'Internal server error',
+                    },
+                    id: null,
+                });
+            }
+        }
+    }
+    async handleSSEConnection(req, res) {
+        console.log('Received GET request to /sse (deprecated SSE transport)');
+        try {
+            const transport = new SSEServerTransport('/messages', res);
+            this.transports.set(transport.sessionId, transport);
+            res.on('close', () => {
+                this.transports.delete(transport.sessionId);
+            });
+            const server = this.createMCPServer();
+            await server.connect(transport);
+        }
+        catch (error) {
+            console.error('Error handling SSE connection:', error);
+            if (!res.headersSent) {
+                res.status(500).json({
+                    jsonrpc: '2.0',
+                    error: {
+                        code: -32603,
+                        message: 'Internal server error',
+                    },
+                    id: null,
+                });
+            }
+        }
+    }
+    async handleSSEMessage(req, res) {
+        const sessionId = req.query.sessionId;
+        try {
+            const transport = this.transports.get(sessionId);
+            if (!transport || !(transport instanceof SSEServerTransport)) {
+                res.status(400).json({
+                    jsonrpc: '2.0',
+                    error: {
+                        code: -32000,
+                        message: 'Bad Request: Session exists but uses a different transport protocol',
+                    },
+                    id: null,
+                });
+                return;
+            }
+            await transport.handlePostMessage(req, res, req.body);
+        }
+        catch (error) {
+            console.error('Error handling SSE message:', error);
+            if (!res.headersSent) {
+                res.status(500).json({
+                    jsonrpc: '2.0',
+                    error: {
+                        code: -32603,
+                        message: 'Internal server error',
+                    },
+                    id: null,
+                });
+            }
+        }
+    }
+    createMCPServer() {
+        const server = new Server({
+            name: this.config.server.name,
+            version: this.config.server.version,
+        }, {
+            capabilities: {
+                tools: {},
+                resources: {},
+            },
+        });
+        // Setup tool handlers
+        server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            return await this.toolHandlers.handleToolRequest(name, args);
+        });
+        server.setRequestHandler(ListToolsRequestSchema, async () => {
+            return {
+                tools: XHS_TOOL_SCHEMAS,
+            };
+        });
+        // Setup resource handlers
+        server.setRequestHandler(ListResourcesRequestSchema, async () => {
+            return {
+                resources: XHS_RESOURCE_SCHEMAS,
+            };
+        });
+        server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+            const { uri } = request.params;
+            return await this.resourceHandlers.handleResourceRequest(uri);
+        });
+        return server;
+    }
+    async start() {
+        return new Promise((resolve, reject) => {
+            const server = this.app.listen(this.port, (error) => {
+                if (error) {
+                    console.error('Failed to start HTTP server:', error);
+                    reject(error);
+                    return;
+                }
+                console.log(`XHS MCP HTTP Server listening on port ${this.port}`);
+                console.log(`
+==============================================
+SUPPORTED TRANSPORT OPTIONS:
+
+1. Streamable HTTP (Protocol version: 2025-03-26)
+   Endpoint: /mcp
+   Methods: GET, POST, DELETE
+   Usage: 
+     - Initialize with POST to /mcp
+     - Establish SSE stream with GET to /mcp
+     - Send requests with POST to /mcp
+     - Terminate session with DELETE to /mcp
+
+2. HTTP + SSE (Protocol version: 2024-11-05)
+   Endpoints: /sse (GET) and /messages (POST)
+   Usage:
+     - Establish SSE stream with GET to /sse
+     - Send requests with POST to /messages?sessionId=<id>
+
+3. Health Check
+   Endpoint: /health
+   Method: GET
+   Usage: Check server status and supported transports
+==============================================
+`);
+                resolve();
+            });
+            // Handle server shutdown
+            process.on('SIGINT', async () => {
+                console.log('Shutting down HTTP server...');
+                // Close all active transports to properly clean up resources
+                for (const [sessionId, transport] of this.transports) {
+                    try {
+                        console.log(`Closing transport for session ${sessionId}`);
+                        await transport.close();
+                    }
+                    catch (error) {
+                        console.error(`Error closing transport for session ${sessionId}:`, error);
+                    }
+                }
+                this.transports.clear();
+                server.close(() => {
+                    console.log('HTTP server shutdown complete');
+                    process.exit(0);
+                });
+            });
+            process.on('SIGTERM', async () => {
+                console.log('Shutting down HTTP server...');
+                // Close all active transports to properly clean up resources
+                for (const [sessionId, transport] of this.transports) {
+                    try {
+                        console.log(`Closing transport for session ${sessionId}`);
+                        await transport.close();
+                    }
+                    catch (error) {
+                        console.error(`Error closing transport for session ${sessionId}:`, error);
+                    }
+                }
+                this.transports.clear();
+                server.close(() => {
+                    console.log('HTTP server shutdown complete');
+                    process.exit(0);
+                });
+            });
+        });
+    }
+    async stop() {
+        // Close all active transports
+        for (const [sessionId, transport] of this.transports) {
+            try {
+                await transport.close();
+            }
+            catch (error) {
+                console.error(`Error closing transport for session ${sessionId}:`, error);
+            }
+        }
+        this.transports.clear();
+    }
+}
+//# sourceMappingURL=http.server.js.map

package/dist/server/http.server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.server.js","sourceRoot":"","sources":["../../src/server/http.server.ts"],"names":[],"mappings":"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"}

package/dist/server/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Server implementation for XHS MCP Server
+ */
+export * from './mcp.server.js';
+export * from './http.server.js';
+export * from './handlers/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,7 @@
+/**
+ * Server implementation for XHS MCP Server
+ */
+export * from './mcp.server.js';
+export * from './http.server.js';
+export * from './handlers/index.js';
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * MCP Server for XiaoHongShu Operations
+ */
+export declare class XHSMCPServer {
+    private server;
+    private toolHandlers;
+    private resourceHandlers;
+    private config;
+    private static instance;
+    constructor();
+    private setupToolHandlers;
+    private setupResourceHandlers;
+    start(): Promise<void>;
+}
+//# sourceMappingURL=mcp.server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.server.d.ts","sourceRoot":"","sources":["../../src/server/mcp.server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAeH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA6B;;IAuBpD,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,qBAAqB;IAavB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}

package/dist/server/mcp.server.js

@@ -0,0 +1,61 @@
+/**
+ * MCP Server for XiaoHongShu Operations
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { getConfig } from '../lib/shared/config.js';
+import { ToolHandlers } from './handlers/tool.handlers.js';
+import { ResourceHandlers } from './handlers/resource.handlers.js';
+import { XHS_TOOL_SCHEMAS, XHS_RESOURCE_SCHEMAS } from './schemas/tool.schemas.js';
+export class XHSMCPServer {
+    server;
+    toolHandlers;
+    resourceHandlers;
+    config;
+    static instance = null;
+    constructor() {
+        this.config = getConfig();
+        this.toolHandlers = new ToolHandlers();
+        this.resourceHandlers = new ResourceHandlers();
+        this.server = new Server({
+            name: this.config.server.name,
+            version: this.config.server.version,
+        }, {
+            capabilities: {
+                tools: {},
+                resources: {},
+            },
+        });
+        this.setupToolHandlers();
+        this.setupResourceHandlers();
+    }
+    setupToolHandlers() {
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            return await this.toolHandlers.handleToolRequest(name, args);
+        });
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            return {
+                tools: XHS_TOOL_SCHEMAS,
+            };
+        });
+    }
+    setupResourceHandlers() {
+        this.server.setRequestHandler(ListResourcesRequestSchema, async () => {
+            return {
+                resources: XHS_RESOURCE_SCHEMAS,
+            };
+        });
+        this.server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+            const { uri } = request.params;
+            return await this.resourceHandlers.handleResourceRequest(uri);
+        });
+    }
+    async start() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        // Don't log to stderr in stdio mode to avoid interfering with MCP protocol
+    }
+}
+//# sourceMappingURL=mcp.server.js.map