@douyinfe/semi-mcp 1.0.11 → 1.0.13

package/dist/http.js

@@ -1326,23 +1326,25 @@ function createMCPServer() {
     });
     return server;
 }
+const sessions = new Map();
+const SESSION_TIMEOUT = 1800000;
 function parseArgs() {
     const args = process.argv.slice(2);
     let port = 3000;
-    let host = '0.0.0.0';
+    let hosts = [];
     let stateless = false;
     let timeout = 30;
     for(let i = 0; i < args.length; i++)if ('--port' === args[i] && args[i + 1]) {
         port = parseInt(args[i + 1], 10);
         i++;
     } else if ('--host' === args[i] && args[i + 1]) {
-        host = args[i + 1];
+        hosts = args[i + 1].split(',').map((h)=>h.trim());
         i++;
     } else if ('-p' === args[i] && args[i + 1]) {
         port = parseInt(args[i + 1], 10);
         i++;
     } else if ('-h' === args[i] && args[i + 1]) {
-        host = args[i + 1];
+        hosts = args[i + 1].split(',').map((h)=>h.trim());
         i++;
     } else if ('--stateless' === args[i]) stateless = true;
     else if ('--timeout' === args[i] && args[i + 1]) {
@@ -1359,7 +1361,12 @@ Usage: semi-mcp-http [options]
 
 Options:
   --port, -p PORT       指定监听端口 (默认: 3000)
-  --host, -h HOST       指定监听地址 (默认: 0.0.0.0)
+  --host, -h HOSTS      指定监听地址，多个地址用逗号分隔 (默认: ::)
+                        :: 表示 IPv6 任意地址（自动支持 IPv4）
+                        0.0.0.0 表示 IPv4 任意地址
+                        ::1 表示 IPv6 本地回环
+                        127.0.0.1 表示 IPv4 本地回环
+                        注意: 如果同时指定 0.0.0.0 和 ::，只使用 ::
   --stateless           无状态模式，不生成 session ID
   --timeout, -t MINUTES 会话超时时间，单位分钟 (默认: 30)
   --help                显示帮助信息
@@ -1373,19 +1380,36 @@ Endpoints:
     }
     return {
         port,
-        host,
+        hosts,
         stateless,
         timeout
     };
 }
+function cleanupSessions() {
+    const now = Date.now();
+    for (const [sessionId, info] of sessions)if (now - info.lastActivity > SESSION_TIMEOUT) {
+        sessions.delete(sessionId);
+        console.log(`[${new Date().toISOString()}] 会话 ${sessionId} 已过期清理`);
+    }
+}
+setInterval(cleanupSessions, 60000);
 async function main() {
-    const { port, host, stateless, timeout } = parseArgs();
+    const { port, hosts, stateless, timeout } = parseArgs();
     const version = getPackageVersion();
+    let processedHosts = hosts;
+    const hasIPv4All = hosts.includes('0.0.0.0');
+    const hasIPv6All = hosts.includes('::');
+    if (hasIPv4All && hasIPv6All) {
+        processedHosts = hosts.filter((h)=>'0.0.0.0' !== h);
+        console.log(`[${new Date().toISOString()}] 检测到同时监听 IPv4 和 IPv6，使用 :: (IPv6) 统一监听`);
+    }
+    if (0 === processedHosts.length) {
+        processedHosts = [
+            '::'
+        ];
+        console.log(`[${new Date().toISOString()}] 使用默认配置: 监听 IPv6 (::)`);
+    }
     const server = createMCPServer();
-    const transport = new StreamableHTTPServerTransport({
-        sessionIdGenerator: stateless ? void 0 : ()=>crypto.randomUUID()
-    });
-    await server.connect(transport);
     console.log(`[${new Date().toISOString()}] MCP 服务器已启动`);
     console.log(`[${new Date().toISOString()}] 模式: ${stateless ? '无状态 (Stateless)' : '有状态 (Stateful)'}`);
     const httpServer = createServer(async (req, res)=>{
@@ -1409,41 +1433,52 @@ async function main() {
                 version,
                 transport: 'streamable-http',
                 stateless,
-                sessionTimeout: `${timeout} minutes`
+                sessionTimeout: `${timeout} minutes`,
+                activeSessions: sessions.size
             }));
             return;
         }
         if ('/mcp' === url.pathname) {
-            let body = '';
-            req.on('data', (chunk)=>{
-                body += chunk.toString();
-            });
-            await new Promise((resolve)=>{
-                req.on('end', async ()=>{
-                    try {
-                        const parsedBody = body ? JSON.parse(body) : void 0;
-                        await transport.handleRequest(req, res, parsedBody);
-                        console.log(`[${new Date().toISOString()}] ${req.method} ${url.pathname} - ${res.statusCode}`);
-                    } catch (error) {
-                        const errorMessage = error instanceof Error ? error.message : String(error);
-                        console.error(`[${new Date().toISOString()}] 请求处理错误:`, errorMessage);
-                        if (!res.headersSent) {
-                            res.writeHead(500, {
-                                'Content-Type': 'application/json'
-                            });
-                            res.end(JSON.stringify({
-                                jsonrpc: '2.0',
-                                error: {
-                                    code: -32000,
-                                    message: errorMessage
-                                },
-                                id: null
-                            }));
-                        }
-                    }
-                    resolve();
-                });
-            });
+            const sessionId = req.headers['mcp-session-id'];
+            try {
+                let transport;
+                if (stateless) {
+                    transport = new StreamableHTTPServerTransport({
+                        sessionIdGenerator: void 0
+                    });
+                    await server.connect(transport);
+                } else if (sessionId && sessions.has(sessionId)) {
+                    transport = sessions.get(sessionId).transport;
+                    sessions.get(sessionId).lastActivity = Date.now();
+                } else {
+                    const newSessionId = crypto.randomUUID();
+                    transport = new StreamableHTTPServerTransport({
+                        sessionIdGenerator: ()=>newSessionId
+                    });
+                    await server.connect(transport);
+                    sessions.set(newSessionId, {
+                        transport,
+                        lastActivity: Date.now()
+                    });
+                }
+                await transport.handleRequest(req, res);
+            } catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                console.error(`[${new Date().toISOString()}] 请求处理错误:`, errorMessage);
+                if (!res.headersSent) {
+                    res.writeHead(500, {
+                        'Content-Type': 'application/json'
+                    });
+                    res.end(JSON.stringify({
+                        jsonrpc: '2.0',
+                        error: {
+                            code: -32000,
+                            message: errorMessage
+                        },
+                        id: null
+                    }));
+                }
+            }
             return;
         }
         if ('/' === url.pathname && 'GET' === req.method) {
@@ -1482,33 +1517,65 @@ async function main() {
             error: '未知的端点'
         }));
     });
-    httpServer.listen(port, host, ()=>{
-        console.log(`
+    const servers = [];
+    let startedCount = 0;
+    console.log(`
 ╔══════════════════════════════════════════════════════════════╗
 ║        Semi MCP Server (Streamable HTTP) v${version.padEnd(10)}        ║
 ╠══════════════════════════════════════════════════════════════╣
-║  服务地址: http://${('0.0.0.0' === host ? 'localhost' : host).padEnd(15)}:${String(port).padEnd(5)}                  ║
 ║  模式: ${stateless ? '无状态 (Stateless)' : '有状态 (Stateful) '}                                 ║
 ║  会话超时: ${String(timeout).padEnd(3)} 分钟                                        ║
-║                                                              ║
-║  端点:                                                       ║
+║                                                              ║`);
+    const formatHost = (h)=>{
+        if ('::' === h) return ':: (所有 IPv6)';
+        if ('0.0.0.0' === h) return '0.0.0.0 (所有 IPv4)';
+        if ('::1' === h) return '::1 (IPv6 本地)';
+        if ('127.0.0.1' === h) return '127.0.0.1 (IPv4 本地)';
+        return h;
+    };
+    processedHosts.forEach((host, index)=>{
+        httpServer.on('error', (err)=>{
+            const displayHost = formatHost(host);
+            console.log(`║  ✗ 端点 ${index + 1}: http://${displayHost}:${port}`);
+            console.error(`[${new Date().toISOString()}] 启动失败 [${host}]:`, err.message);
+        });
+        httpServer.listen(port, host, ()=>{
+            startedCount++;
+            const displayHost = formatHost(host);
+            console.log(`║  ✓ 端点 ${index + 1}: http://${displayHost}:${port}`);
+            if (startedCount === processedHosts.length) {
+                console.log(`║                                                              ║
+║  可用端点:                                                   ║
 ║    POST   /mcp      发送 MCP 请求                            ║
 ║    GET    /mcp      SSE 流 (服务器推送)                      ║
 ║    GET    /health   健康检查                                 ║
 ╚══════════════════════════════════════════════════════════════╝
 `);
+                console.log(`[${new Date().toISOString()}] 所有服务器已启动，监听 ${processedHosts.length} 个地址`);
+                console.log(`[${new Date().toISOString()}] 总计监听: ${processedHosts.join(', ')}`);
+            }
+        });
+        servers.push(httpServer);
     });
     const shutdown = async ()=>{
         console.log('\n正在关闭服务器...');
-        try {
-            await transport.close();
-            console.log('Transport 已关闭');
+        for (const [sessionId, info] of sessions)try {
+            await info.transport.close();
+            console.log(`[${new Date().toISOString()}] 会话 ${sessionId} 已关闭`);
         } catch (error) {
-            console.error('关闭 transport 时出错:', error);
+            console.error(`关闭会话 ${sessionId} 时出错:`, error);
         }
-        httpServer.close(()=>{
-            console.log('服务器已关闭');
-            process.exit(0);
+        sessions.clear();
+        let closedCount = 0;
+        servers.forEach((server, index)=>{
+            server.close(()=>{
+                closedCount++;
+                console.log(`[${new Date().toISOString()}] 服务器 ${index + 1}/${servers.length} 已关闭`);
+                if (closedCount === servers.length) {
+                    console.log('所有服务器已关闭');
+                    process.exit(0);
+                }
+            });
         });
     };
     process.on('SIGINT', shutdown);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@douyinfe/semi-mcp",
-  "version": "1.0.11",
+  "version": "1.0.13",
   "description": "Semi Design MCP Server - Model Context Protocol server for Semi Design components and documentation",
   "type": "module",
   "main": "./dist/index.js",