@douyinfe/semi-mcp 1.0.11 → 1.0.12

package/dist/http.js

@@ -1329,20 +1329,20 @@ function createMCPServer() {
 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 +1359,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,14 +1378,27 @@ Endpoints:
     }
     return {
         port,
-        host,
+        hosts,
         stateless,
         timeout
     };
 }
 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()
@@ -1482,22 +1500,47 @@ 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);
     });
+    processedHosts.length;
     const shutdown = async ()=>{
         console.log('\n正在关闭服务器...');
         try {
@@ -1506,9 +1549,16 @@ async function main() {
         } catch (error) {
             console.error('关闭 transport 时出错:', error);
         }
-        httpServer.close(()=>{
-            console.log('服务器已关闭');
-            process.exit(0);
+        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.12",
   "description": "Semi Design MCP Server - Model Context Protocol server for Semi Design components and documentation",
   "type": "module",
   "main": "./dist/index.js",