@douyinfe/semi-mcp 1.0.10 → 1.0.12

package/dist/http.js

@@ -1,6 +1,5 @@
 #!/usr/bin/env node
 import { createServer } from "http";
-import { randomUUID } from "crypto";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema } from "@modelcontextprotocol/sdk/types.js";
@@ -1330,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]) {
@@ -1360,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                显示帮助信息
@@ -1368,55 +1372,46 @@ Options:
 Endpoints:
   POST /mcp         MCP 消息端点 (Streamable HTTP)
   GET  /mcp         SSE 流端点 (用于服务器推送)
-  DELETE /mcp       关闭会话
   GET  /health      健康检查端点
 `);
         process.exit(0);
     }
     return {
         port,
-        host,
+        hosts,
         stateless,
         timeout
     };
 }
-const sessions = new Map();
-function touchSession(sessionId) {
-    const session = sessions.get(sessionId);
-    if (session) session.lastActivity = Date.now();
-}
-async function cleanupExpiredSessions(timeoutMs) {
-    const now = Date.now();
-    const expiredSessions = [];
-    sessions.forEach((session, sessionId)=>{
-        if (now - session.lastActivity > timeoutMs) expiredSessions.push(sessionId);
-    });
-    for (const sessionId of expiredSessions){
-        const session = sessions.get(sessionId);
-        if (session) {
-            console.log(`[${new Date().toISOString()}] 会话超时清理: ${sessionId} (空闲 ${Math.round((now - session.lastActivity) / 1000 / 60)} 分钟)`);
-            try {
-                await session.transport.close();
-            } catch  {}
-            sessions.delete(sessionId);
-        }
-    }
-}
 async function main() {
-    const { port, host, stateless, timeout } = parseArgs();
+    const { port, hosts, stateless, timeout } = parseArgs();
     const version = getPackageVersion();
-    const timeoutMs = 60 * timeout * 1000;
-    const cleanupInterval = setInterval(()=>{
-        cleanupExpiredSessions(timeoutMs).catch((error)=>{
-            console.error(`[${new Date().toISOString()}] 会话清理错误:`, error);
-        });
-    }, 60000);
+    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)=>{
         const url = new URL(req.url || '/', `http://${req.headers.host}`);
         res.setHeader('Access-Control-Allow-Origin', '*');
         res.setHeader('Access-Control-Allow-Methods', 'GET, POST, DELETE, OPTIONS');
-        res.setHeader('Access-Control-Allow-Headers', 'Content-Type, mcp-session-id');
-        res.setHeader('Access-Control-Expose-Headers', 'mcp-session-id');
+        res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Mcp-Session-Id');
+        res.setHeader('Access-Control-Expose-Headers', 'Mcp-Session-Id');
         if ('OPTIONS' === req.method) {
             res.writeHead(204);
             res.end();
@@ -1432,168 +1427,42 @@ async function main() {
                 version,
                 transport: 'streamable-http',
                 stateless,
-                sessionTimeout: `${timeout} minutes`,
-                activeSessions: sessions.size
+                sessionTimeout: `${timeout} minutes`
             }));
             return;
         }
         if ('/mcp' === url.pathname) {
-            const sessionId = req.headers['mcp-session-id'];
-            if ('POST' === req.method) {
-                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;
-                            const isInitialize = parsedBody?.method === 'initialize';
-                            if (isInitialize) {
-                                const server = createMCPServer();
-                                const transport = new StreamableHTTPServerTransport({
-                                    sessionIdGenerator: stateless ? void 0 : ()=>randomUUID()
-                                });
-                                await server.connect(transport);
-                                transport.onclose = ()=>{
-                                    const sid = transport.sessionId;
-                                    if (sid) {
-                                        console.log(`[${new Date().toISOString()}] 会话关闭: ${sid}`);
-                                        sessions.delete(sid);
-                                    }
-                                };
-                                await transport.handleRequest(req, res, parsedBody);
-                                const newSessionId = transport.sessionId;
-                                if (newSessionId) {
-                                    sessions.set(newSessionId, {
-                                        transport,
-                                        lastActivity: Date.now()
-                                    });
-                                    console.log(`[${new Date().toISOString()}] 新会话创建: ${newSessionId}`);
-                                }
-                            } else {
-                                if (!sessionId) {
-                                    res.writeHead(400, {
-                                        'Content-Type': 'application/json'
-                                    });
-                                    res.end(JSON.stringify({
-                                        jsonrpc: '2.0',
-                                        error: {
-                                            code: -32000,
-                                            message: 'Bad Request: Missing mcp-session-id header'
-                                        },
-                                        id: parsedBody?.id ?? null
-                                    }));
-                                    resolve();
-                                    return;
-                                }
-                                const session = sessions.get(sessionId);
-                                if (!session) {
-                                    res.writeHead(404, {
-                                        'Content-Type': 'application/json'
-                                    });
-                                    res.end(JSON.stringify({
-                                        jsonrpc: '2.0',
-                                        error: {
-                                            code: -32000,
-                                            message: 'Not Found: Session not found or expired'
-                                        },
-                                        id: parsedBody?.id ?? null
-                                    }));
-                                    resolve();
-                                    return;
-                                }
-                                touchSession(sessionId);
-                                await session.transport.handleRequest(req, res, parsedBody);
-                            }
-                        } 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
-                                }));
-                            }
+            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();
-                    });
+                    }
+                    resolve();
                 });
-                return;
-            }
-            if ('GET' === req.method) {
-                if (!sessionId) {
-                    res.writeHead(400, {
-                        'Content-Type': 'application/json'
-                    });
-                    res.end(JSON.stringify({
-                        jsonrpc: '2.0',
-                        error: {
-                            code: -32000,
-                            message: 'Bad Request: Missing mcp-session-id header'
-                        },
-                        id: null
-                    }));
-                    return;
-                }
-                const session = sessions.get(sessionId);
-                if (!session) {
-                    res.writeHead(404, {
-                        'Content-Type': 'application/json'
-                    });
-                    res.end(JSON.stringify({
-                        jsonrpc: '2.0',
-                        error: {
-                            code: -32000,
-                            message: 'Not Found: Session not found'
-                        },
-                        id: null
-                    }));
-                    return;
-                }
-                touchSession(sessionId);
-                await session.transport.handleRequest(req, res);
-                return;
-            }
-            if ('DELETE' === req.method) {
-                if (!sessionId) {
-                    res.writeHead(400, {
-                        'Content-Type': 'application/json'
-                    });
-                    res.end(JSON.stringify({
-                        error: 'Missing mcp-session-id header'
-                    }));
-                    return;
-                }
-                const session = sessions.get(sessionId);
-                if (session) {
-                    await session.transport.close();
-                    sessions.delete(sessionId);
-                    console.log(`[${new Date().toISOString()}] 会话已删除: ${sessionId}`);
-                    res.writeHead(200, {
-                        'Content-Type': 'application/json'
-                    });
-                    res.end(JSON.stringify({
-                        success: true,
-                        message: '会话已关闭'
-                    }));
-                } else {
-                    res.writeHead(404, {
-                        'Content-Type': 'application/json'
-                    });
-                    res.end(JSON.stringify({
-                        error: '会话不存在'
-                    }));
-                }
-                return;
-            }
+            });
+            return;
         }
         if ('/' === url.pathname && 'GET' === req.method) {
             res.writeHead(200, {
@@ -1608,19 +1477,18 @@ async function main() {
                 sessionTimeout: `${timeout} minutes`,
                 endpoints: {
                     mcp: {
-                        POST: '/mcp - 发送 MCP 请求 (初始化请求无需 session ID)',
-                        GET: '/mcp - SSE 流 (需要 mcp-session-id 头)',
-                        DELETE: '/mcp - 关闭会话'
+                        POST: '/mcp - 发送 MCP 请求',
+                        GET: '/mcp - SSE 流 (需要 Mcp-Session-Id 头)'
                     },
                     health: '/health - 健康检查'
                 },
                 headers: {
-                    'mcp-session-id': '会话 ID (初始化响应后获取，后续请求需携带)'
+                    'Mcp-Session-Id': '会话 ID (初始化响应后获取，后续请求需携带)'
                 },
                 usage: {
-                    step1: '发送 initialize 请求获取 session ID',
-                    step2: '后续请求携带 mcp-session-id 头',
-                    example: `curl -X POST http://${'0.0.0.0' === host ? 'localhost' : host}:${port}/mcp -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -d '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}},"id":1}'`
+                    step1: '客户端发送 initialize 请求',
+                    step2: '服务器返回响应并包含 Mcp-Session-Id header',
+                    step3: '后续请求携带 Mcp-Session-Id header'
                 }
             }, null, 2));
             return;
@@ -1632,35 +1500,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 流 (服务器推送)                      ║
-║    DELETE /mcp      关闭会话                                 ║
 ║    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正在关闭服务器...');
-        clearInterval(cleanupInterval);
-        const sessionEntries = Array.from(sessions.entries());
-        for (const [sessionId, session] of sessionEntries){
-            console.log(`关闭会话: ${sessionId}`);
-            await session.transport.close();
+        try {
+            await transport.close();
+            console.log('Transport 已关闭');
+        } catch (error) {
+            console.error('关闭 transport 时出错:', error);
         }
-        sessions.clear();
-        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.10",
+  "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",