xhs-mcp 0.6.0

package/dist/server/mcp.server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.server.js","sourceRoot":"","sources":["../../src/server/mcp.server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEnF,MAAM,OAAO,YAAY;IACf,MAAM,CAAS;IACf,YAAY,CAAe;IAC3B,gBAAgB,CAAmB;IACnC,MAAM,CAA+B;IACrC,MAAM,CAAC,QAAQ,GAAwB,IAAI,CAAC;IAEpD;QACE,IAAI,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;QAC1B,IAAI,CAAC,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC;QACvC,IAAI,CAAC,gBAAgB,GAAG,IAAI,gBAAgB,EAAE,CAAC;QAC/C,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CACtB;YACE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI;YAC7B,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO;SACpC,EACD;YACE,YAAY,EAAE;gBACZ,KAAK,EAAE,EAAE;gBACT,SAAS,EAAE,EAAE;aACd;SACF,CACF,CAAC;QAEF,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,IAAI,CAAC,qBAAqB,EAAE,CAAC;IAC/B,CAAC;IAEO,iBAAiB;QACvB,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACrE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;YACjD,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;YAC/D,OAAO;gBACL,KAAK,EAAE,gBAAgB;aACxB,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,qBAAqB;QAC3B,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;YACnE,OAAO;gBACL,SAAS,EAAE,oBAAoB;aAChC,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,yBAAyB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACzE,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;YAC/B,OAAO,MAAM,IAAI,CAAC,gBAAgB,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACrC,2EAA2E;IAC7E,CAAC"}

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

@@ -0,0 +1,20 @@
+/**
+ * Tool schemas for XHS MCP Server
+ */
+export interface ToolSchema {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, any>;
+        required?: string[];
+    };
+}
+export declare const XHS_TOOL_SCHEMAS: ToolSchema[];
+export declare const XHS_RESOURCE_SCHEMAS: {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+}[];
+//# sourceMappingURL=tool.schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool.schemas.d.ts","sourceRoot":"","sources":["../../../src/server/schemas/tool.schemas.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED,eAAO,MAAM,gBAAgB,EAAE,UAAU,EAyJxC,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;GAmBhC,CAAC"}

package/dist/server/schemas/tool.schemas.js

@@ -0,0 +1,178 @@
+/**
+ * Tool schemas for XHS MCP Server
+ */
+export const XHS_TOOL_SCHEMAS = [
+    {
+        name: 'xhs_auth_login',
+        description: 'Start XiaoHongShu login process.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                browser_path: {
+                    type: 'string',
+                    description: 'Optional custom browser binary path',
+                },
+            },
+        },
+    },
+    {
+        name: 'xhs_auth_logout',
+        description: 'Logout from XiaoHongShu (clears saved cookies).',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'xhs_auth_status',
+        description: 'Check XiaoHongShu login status (fast check with browser).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                browser_path: {
+                    type: 'string',
+                    description: 'Optional custom browser binary path',
+                },
+            },
+        },
+    },
+    {
+        name: 'xhs_discover_feeds',
+        description: 'Get home page feed list.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                browser_path: {
+                    type: 'string',
+                    description: 'Optional custom browser binary path',
+                },
+            },
+        },
+    },
+    {
+        name: 'xhs_search_note',
+        description: 'Search for notes by keyword.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                keyword: {
+                    type: 'string',
+                    description: 'Search keyword (required)',
+                },
+                browser_path: {
+                    type: 'string',
+                    description: 'Optional custom browser binary path',
+                },
+            },
+            required: ['keyword'],
+        },
+    },
+    {
+        name: 'xhs_get_note_detail',
+        description: 'Get detailed information about a specific note.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                feed_id: {
+                    type: 'string',
+                    description: 'Feed ID (required)',
+                },
+                xsec_token: {
+                    type: 'string',
+                    description: 'Security token for the feed (required)',
+                },
+                browser_path: {
+                    type: 'string',
+                    description: 'Optional custom browser binary path',
+                },
+            },
+            required: ['feed_id', 'xsec_token'],
+        },
+    },
+    {
+        name: 'xhs_comment_on_note',
+        description: 'Comment on a note.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                feed_id: {
+                    type: 'string',
+                    description: 'Feed ID (required)',
+                },
+                xsec_token: {
+                    type: 'string',
+                    description: 'Security token for the feed (required)',
+                },
+                note: {
+                    type: 'string',
+                    description: 'Comment note (required)',
+                },
+                browser_path: {
+                    type: 'string',
+                    description: 'Optional custom browser binary path',
+                },
+            },
+            required: ['feed_id', 'xsec_token', 'note'],
+        },
+    },
+    {
+        name: 'xhs_publish_content',
+        description: 'Publish content to XiaoHongShu (supports both images and videos).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                type: {
+                    type: 'string',
+                    enum: ['image', 'video'],
+                    description: 'Content type: "image" for images, "video" for videos (required)',
+                },
+                title: {
+                    type: 'string',
+                    description: 'Content title (required, max 20 characters)',
+                    maxLength: 20,
+                },
+                content: {
+                    type: 'string',
+                    description: 'Content description (required, max 1000 characters)',
+                    maxLength: 1000,
+                },
+                media_paths: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'List of media file paths (required, non-empty). For images: 1-18 image files. For videos: exactly 1 video file.',
+                    maxItems: 18,
+                },
+                tags: {
+                    type: 'string',
+                    description: 'Comma-separated tags (optional)',
+                },
+                browser_path: {
+                    type: 'string',
+                    description: 'Optional custom browser binary path',
+                },
+            },
+            required: ['type', 'title', 'content', 'media_paths'],
+        },
+    },
+];
+export const XHS_RESOURCE_SCHEMAS = [
+    {
+        uri: 'xhs://cookies',
+        name: 'XHS Authentication Cookies',
+        description: 'Current XiaoHongShu authentication cookies and info',
+        mimeType: 'application/json',
+    },
+    {
+        uri: 'xhs://config',
+        name: 'XHS Server Configuration',
+        description: 'XHS MCP server configuration',
+        mimeType: 'application/json',
+    },
+    {
+        uri: 'xhs://status',
+        name: 'XHS Server Status',
+        description: 'Current server and authentication status',
+        mimeType: 'application/json',
+    },
+];
+//# sourceMappingURL=tool.schemas.js.map

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

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

package/dist/utils/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Utility functions for XHS MCP Server
+ */
+export * from './xhs.utils.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,gBAAgB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,5 @@
+/**
+ * Utility functions for XHS MCP Server
+ */
+export * from './xhs.utils.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,gBAAgB,CAAC"}

package/dist/utils/xhs.utils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Utility functions for XHS operations
+ */
+import { Page } from 'puppeteer';
+export declare const XHS_HOME_URL = "https://www.xiaohongshu.com";
+export declare const XHS_EXPLORE_URL = "https://www.xiaohongshu.com/explore";
+export declare const XHS_SEARCH_URL = "https://www.xiaohongshu.com/search_result";
+export declare const XHS_CREATOR_PUBLISH_URL = "https://creator.xiaohongshu.com/publish/publish?source=official";
+export declare const LOGIN_OK_SELECTOR = ".main-container .user .link-wrapper .channel";
+export declare function makeSearchUrl(keyword: string): string;
+export declare function makeFeedDetailUrl(feedId: string, xsecToken: string): string;
+export declare function extractInitialState(page: Page): Promise<Record<string, unknown> | null>;
+export declare function isLoggedIn(page: Page): Promise<boolean>;
+//# sourceMappingURL=xhs.utils.d.ts.map

package/dist/utils/xhs.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xhs.utils.d.ts","sourceRoot":"","sources":["../../src/utils/xhs.utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,eAAO,MAAM,YAAY,gCAAgC,CAAC;AAC1D,eAAO,MAAM,eAAe,wCAA4B,CAAC;AACzD,eAAO,MAAM,cAAc,8CAAkC,CAAC;AAC9D,eAAO,MAAM,uBAAuB,oEAAoE,CAAC;AACzG,eAAO,MAAM,iBAAiB,iDAAiD,CAAC;AAEhF,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMrD;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAM3E;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAoD7F;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAO7D"}

package/dist/utils/xhs.utils.js

@@ -0,0 +1,84 @@
+/**
+ * Utility functions for XHS operations
+ */
+export const XHS_HOME_URL = 'https://www.xiaohongshu.com';
+export const XHS_EXPLORE_URL = `${XHS_HOME_URL}/explore`;
+export const XHS_SEARCH_URL = `${XHS_HOME_URL}/search_result`;
+export const XHS_CREATOR_PUBLISH_URL = 'https://creator.xiaohongshu.com/publish/publish?source=official';
+export const LOGIN_OK_SELECTOR = '.main-container .user .link-wrapper .channel';
+export function makeSearchUrl(keyword) {
+    const params = new URLSearchParams({
+        keyword,
+        source: 'web_explore_feed',
+    });
+    return `${XHS_SEARCH_URL}?${params.toString()}`;
+}
+export function makeFeedDetailUrl(feedId, xsecToken) {
+    const params = new URLSearchParams({
+        xsec_token: xsecToken,
+        xsec_source: 'pc_feed',
+    });
+    return `${XHS_EXPLORE_URL}/${feedId}?${params.toString()}`;
+}
+export async function extractInitialState(page) {
+    try {
+        // Wait for page to be fully loaded - Puppeteer doesn't have waitForLoadState
+        // We'll just wait a bit for the page to settle
+        await new Promise(resolve => setTimeout(resolve, 1000));
+    }
+    catch {
+        // Ignore load state errors
+    }
+    try {
+        const result = await page.evaluate(`
+      (() => {
+        // Try multiple possible state objects
+        const possibleStates = [
+          window.__INITIAL_STATE__,
+          window.__INITIAL_SSR_STATE__,
+          window.__NEXT_DATA__,
+          window.__NUXT__,
+          window.__VUE__,
+          window.__REACT_QUERY_STATE__
+        ];
+
+        for (const state of possibleStates) {
+          if (state && typeof state === 'object') {
+            return JSON.stringify(state);
+          }
+        }
+
+        // If no state found, try to find any global state
+        const globalKeys = Object.keys(window).filter(key =>
+          key.includes('STATE') || key.includes('DATA') || key.includes('INITIAL')
+        );
+
+        for (const key of globalKeys) {
+          const value = window[key];
+          if (value && typeof value === 'object') {
+            return JSON.stringify(value);
+          }
+        }
+
+        return '';
+      })()
+    `);
+        if (!result) {
+            return null;
+        }
+        return JSON.parse(result);
+    }
+    catch {
+        return null;
+    }
+}
+export async function isLoggedIn(page) {
+    try {
+        const elements = await page.$$(LOGIN_OK_SELECTOR);
+        return elements.length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=xhs.utils.js.map

package/dist/utils/xhs.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xhs.utils.js","sourceRoot":"","sources":["../../src/utils/xhs.utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,CAAC,MAAM,YAAY,GAAG,6BAA6B,CAAC;AAC1D,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,YAAY,UAAU,CAAC;AACzD,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,YAAY,gBAAgB,CAAC;AAC9D,MAAM,CAAC,MAAM,uBAAuB,GAAG,iEAAiE,CAAC;AACzG,MAAM,CAAC,MAAM,iBAAiB,GAAG,8CAA8C,CAAC;AAEhF,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QACjC,OAAO;QACP,MAAM,EAAE,kBAAkB;KAC3B,CAAC,CAAC;IACH,OAAO,GAAG,cAAc,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,SAAiB;IACjE,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QACjC,UAAU,EAAE,SAAS;QACrB,WAAW,EAAE,SAAS;KACvB,CAAC,CAAC;IACH,OAAO,GAAG,eAAe,IAAI,MAAM,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAU;IAClD,IAAI,CAAC;QACH,6EAA6E;QAC7E,+CAA+C;QAC/C,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,2BAA2B;IAC7B,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAgClC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,MAAgB,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAU;IACzC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC;QAClD,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/docs/HTTP_TRANSPORTS.md

@@ -0,0 +1,269 @@
+---
+noteId: "aa57c8c098f311f0a8e11dcb3e2fc94e"
+tags: []
+---
+# HTTP Transports Support
+
+XHS MCP Server now supports both SSE (Server-Sent Events) and Streamable HTTP transports, in addition to the traditional stdio transport.
+
+## Transport Options
+
+### 1. Streamable HTTP (Recommended)
+
+- **Protocol Version**: 2025-03-26
+- **Endpoint**: `/mcp`
+- **Methods**: GET, POST, DELETE
+- **Features**:
+  - Unified endpoint for all operations
+  - Session management with resumability
+  - On-demand streaming
+  - Stateless server support
+
+### 2. HTTP + SSE (Legacy)
+
+- **Protocol Version**: 2024-11-05
+- **Endpoints**:
+  - `/sse` (GET) - Establish SSE stream
+  - `/messages` (POST) - Send messages
+- **Features**:
+  - Traditional SSE implementation
+  - Backward compatibility
+
+### 3. Stdio (Default)
+
+- **Protocol**: Standard MCP stdio transport
+- **Usage**: Direct process communication
+- **Features**:
+  - Zero configuration
+  - Process-based communication
+
+## Usage
+
+### Starting the HTTP Server
+
+```bash
+# Start HTTP server on default port 3000
+npm run start:http
+
+# Start HTTP server on custom port
+npm run start:http -- --port 8080
+
+# Development mode with HTTP server
+npm run dev:http
+
+# Development mode with custom port
+npm run dev:http -- --port 8080
+```
+
+### Command Line Options
+
+```bash
+# Show help
+node dist/index.js --help
+
+# Start in stdio mode (default)
+node dist/index.js --mode stdio
+
+# Start in HTTP mode
+node dist/index.js --mode http --port 3000
+```
+
+## API Endpoints
+
+### Health Check
+
+```
+GET /health
+```
+
+Returns server status and supported transports.
+
+**Response:**
+
+```json
+{
+  "status": "healthy",
+  "server": "xhs-mcp",
+  "version": "0.2.10",
+  "transports": ["streamable-http", "sse"]
+}
+```
+
+### Streamable HTTP Transport
+
+#### Initialize Session
+
+```
+POST /mcp
+Content-Type: application/json
+
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "method": "initialize",
+  "params": {
+    "protocolVersion": "2025-03-26",
+    "capabilities": {},
+    "clientInfo": {
+      "name": "client-name",
+      "version": "1.0.0"
+    }
+  }
+}
+```
+
+**Response Headers:**
+
+```
+Mcp-Session-Id: <session-id>
+```
+
+#### Send Requests
+
+```
+POST /mcp
+Content-Type: application/json
+Mcp-Session-Id: <session-id>
+
+{
+  "jsonrpc": "2.0",
+  "id": 2,
+  "method": "tools/list"
+}
+```
+
+#### Establish SSE Stream
+
+```
+GET /mcp
+Mcp-Session-Id: <session-id>
+```
+
+#### Terminate Session
+
+```
+DELETE /mcp
+Mcp-Session-Id: <session-id>
+```
+
+### SSE Transport (Legacy)
+
+#### Establish SSE Stream
+
+```
+GET /sse
+```
+
+#### Send Messages
+
+```
+POST /messages?sessionId=<session-id>
+Content-Type: application/json
+
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "method": "initialize",
+  "params": {
+    "protocolVersion": "2024-11-05",
+    "capabilities": {},
+    "clientInfo": {
+      "name": "client-name",
+      "version": "1.0.0"
+    }
+  }
+}
+```
+
+## Testing
+
+A test script is provided to verify the HTTP server functionality:
+
+```bash
+# Start the HTTP server in one terminal
+npm run dev:http
+
+# Run tests in another terminal
+node test-http-server.js
+```
+
+## Configuration
+
+### Environment Variables
+
+- `XHS_ENABLE_LOGGING=true` - Enable detailed logging
+- `PORT` - HTTP server port (default: 3000)
+
+### CORS Configuration
+
+The HTTP server is configured with permissive CORS settings for development:
+
+```javascript
+app.use(cors({
+  origin: '*', // Allow all origins
+  exposedHeaders: ['Mcp-Session-Id']
+}));
+```
+
+For production, you should restrict the `origin` to specific domains.
+
+## Security Considerations
+
+### DNS Rebinding Protection
+
+Both SSE and Streamable HTTP transports support DNS rebinding protection:
+
+```javascript
+const transport = new SSEServerTransport('/messages', res, {
+  allowedHosts: ['localhost', '127.0.0.1'],
+  allowedOrigins: ['http://localhost:3000'],
+  enableDnsRebindingProtection: true
+});
+```
+
+### Session Management
+
+- Session IDs are generated using cryptographically secure UUIDs
+- Sessions are automatically cleaned up when connections close
+- Invalid session IDs are rejected with appropriate error responses
+
+## Migration Guide
+
+### From Stdio to HTTP
+
+1. **Update client configuration** to use HTTP endpoints instead of stdio
+2. **Handle session management** for stateful operations
+3. **Implement proper error handling** for HTTP-specific errors
+4. **Consider CORS requirements** for browser-based clients
+
+### From SSE to Streamable HTTP
+
+1. **Update protocol version** from `2024-11-05` to `2025-03-26`
+2. **Use unified `/mcp` endpoint** instead of separate `/sse` and `/messages`
+3. **Implement session ID handling** in request headers
+4. **Update client to handle** both streaming and direct responses
+
+## Troubleshooting
+
+### Common Issues
+
+1. **Port already in use**: Change the port using `--port` option
+2. **CORS errors**: Configure allowed origins in production
+3. **Session not found**: Ensure session ID is properly included in headers
+4. **Connection timeouts**: Check network configuration and firewall 
+
+### Debug Mode
+
+Enable detailed logging:
+
+```bash
+XHS_ENABLE_LOGGING=true npm run dev:http
+```
+
+### Health Check
+
+Always verify server status:
+
+```bash
+curl http://localhost:3000/health
+```

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "xhs-mcp",
+  "version": "0.6.0",
+  "description": "XiaoHongShu CLI and MCP Server",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "xhs-cli": "dist/cli/xhs-cli.js"
+  },
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md",
+    "docs"
+  ],
+  "scripts": {
+    "build": "npm run clean && tsc",
+    "start:cli": "node dist/cli/xhs-cli.js --help",
+    "dev:cli": "tsx src/cli/xhs-cli.ts --help",
+    "dev:mcp:stdio": "tsx src/cli/xhs-cli.ts mcp --mode stdio",
+    "dev:mcp:http": "tsx src/cli/xhs-cli.ts mcp --mode http",
+    "clean": "rm -rf dist temp_images/*",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "format": "prettier --write src/**/*.ts",
+    "format:check": "prettier --check src/**/*.ts"
+  },
+  "keywords": [
+    "xiaohongshu",
+    "mcp",
+    "model-context-protocol",
+    "automation",
+    "puppeteer"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.3",
+    "commander": "^12.0.0",
+    "cors": "^2.8.5",
+    "express": "^5.1.0",
+    "node-fetch": "^3.3.2",
+    "puppeteer": "^22.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "prettier": "^3.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}