wechaty-web-panel 1.6.112 → 1.6.113

package/dist/mcp/streamable-examples.js

@@ -0,0 +1,283 @@
+/**
+ * MCP Streamable HTTP 使用示例
+ *
+ * 展示如何通过 Streamable HTTP 接口调用微信聊天数据 MCP 服务
+ */
+const BASE_URL = 'http://localhost:3001';
+/**
+ * 发送 MCP 请求的辅助函数
+ */
+async function mcpRequest(method, params = {}, sessionId = null) {
+    const headers = {
+        'Content-Type': 'application/json',
+        'Accept': 'application/json, text/event-stream', // MCP Streamable HTTP要求的Accept头部
+    };
+    if (sessionId) {
+        headers['Mcp-Session-Id'] = sessionId;
+    }
+    const body = {
+        jsonrpc: '2.0',
+        method: method,
+        params: params,
+        id: Date.now()
+    };
+    try {
+        const response = await fetch(`${BASE_URL}/mcp`, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(body)
+        });
+        const result = await response.json();
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${result.error?.message || '请求失败'}`);
+        }
+        // 获取会话ID（如果是新会话）
+        const newSessionId = response.headers.get('Mcp-Session-Id');
+        return {
+            data: result,
+            sessionId: newSessionId || sessionId
+        };
+    }
+    catch (error) {
+        console.error(`MCP 请求失败 ${method}:`, error.message);
+        throw error;
+    }
+}
+/**
+ * 初始化 MCP 会话
+ */
+async function initializeSession() {
+    console.log('🔄 初始化 MCP 会话...');
+    const response = await mcpRequest('initialize', {
+        protocolVersion: '2025-06-18',
+        capabilities: {
+            tools: {}
+        },
+        clientInfo: {
+            name: 'streamable-examples',
+            version: '1.0.0'
+        }
+    });
+    console.log('✅ 会话初始化成功，会话ID:', response.sessionId);
+    return response.sessionId;
+}
+/**
+ * 获取可用工具列表
+ */
+async function listTools(sessionId) {
+    console.log('\n📋 获取可用工具列表...');
+    const response = await mcpRequest('tools/list', {}, sessionId);
+    const tools = response.data.result.tools;
+    console.log(`✅ 共发现 ${tools.length} 个可用工具:`);
+    tools.slice(0, 5).forEach(tool => {
+        console.log(`   🔧 ${tool.name}: ${tool.description}`);
+    });
+    if (tools.length > 5) {
+        console.log(`   ... 还有 ${tools.length - 5} 个工具`);
+    }
+    return tools;
+}
+/**
+ * 调用工具示例
+ */
+async function callToolExample(sessionId) {
+    console.log('\n🛠️ 调用工具示例...');
+    try {
+        // 示例1: 搜索好友
+        console.log('1️⃣ 搜索好友示例:');
+        const friendsResponse = await mcpRequest('tools/call', {
+            name: 'search_friends',
+            arguments: {
+                robotId: 'robot_streamable_demo',
+                keyword: '测试',
+                limit: 3
+            }
+        }, sessionId);
+        const friendsResult = JSON.parse(friendsResponse.data.result.content[0].text);
+        console.log('   ✅ 搜索结果:', friendsResult.data?.length || 0, '条记录');
+        // 示例2: 获取系统信息
+        console.log('\n2️⃣ 获取系统信息示例:');
+        const systemResponse = await mcpRequest('tools/call', {
+            name: 'get_system_info',
+            arguments: {}
+        }, sessionId);
+        const systemResult = JSON.parse(systemResponse.data.result.content[0].text);
+        console.log('   ✅ 系统状态:', systemResult.database?.status || '未知');
+        // 示例3: 批量创建好友
+        console.log('\n3️⃣ 批量创建好友示例:');
+        const batchResponse = await mcpRequest('tools/call', {
+            name: 'batch_create_friends',
+            arguments: {
+                robotId: 'robot_streamable_demo',
+                friends: [
+                    {
+                        robotId: 'robot_streamable_demo',
+                        wxid: 'streamable_friend_001',
+                        name: 'Streamable测试好友1',
+                        remark: '通过Streamable HTTP创建',
+                        tags: 'Streamable,测试'
+                    },
+                    {
+                        robotId: 'robot_streamable_demo',
+                        wxid: 'streamable_friend_002',
+                        name: 'Streamable测试好友2',
+                        remark: '批量创建测试'
+                    }
+                ],
+                updateOnDuplicate: true
+            }
+        }, sessionId);
+        const batchResult = JSON.parse(batchResponse.data.result.content[0].text);
+        console.log('   ✅ 批量创建结果:', batchResult.message);
+    }
+    catch (error) {
+        console.log('   ⚠️ 工具调用失败（可能是数据库未连接）:', error.message);
+    }
+}
+/**
+ * 会话管理示例
+ */
+async function sessionManagementExample() {
+    console.log('\n🔄 会话管理示例...');
+    // 创建新会话
+    const sessionId = await initializeSession();
+    // 使用会话调用工具
+    await mcpRequest('tools/call', {
+        name: 'get_system_info',
+        arguments: {}
+    }, sessionId);
+    console.log('✅ 使用会话调用工具成功');
+    // 删除会话
+    try {
+        const deleteResponse = await fetch(`${BASE_URL}/mcp`, {
+            method: 'DELETE',
+            headers: {
+                'Mcp-Session-Id': sessionId
+            }
+        });
+        if (deleteResponse.ok) {
+            console.log('✅ 会话删除成功');
+        }
+        else {
+            console.log('⚠️ 会话删除失败');
+        }
+    }
+    catch (error) {
+        console.log('⚠️ 会话删除请求失败:', error.message);
+    }
+}
+/**
+ * 无状态模式示例
+ */
+async function statelessModeExample() {
+    console.log('\n🔄 无状态模式示例（无需会话管理）...');
+    try {
+        // 直接调用，无需会话初始化
+        const response = await mcpRequest('tools/call', {
+            name: 'get_system_info',
+            arguments: {}
+        });
+        console.log('✅ 无状态调用成功，无会话ID');
+    }
+    catch (error) {
+        console.log('⚠️ 无状态调用失败:', error.message);
+        console.log('   提示：确保服务器运行在无状态模式');
+    }
+}
+/**
+ * 运行所有示例
+ */
+async function runStreamableExamples() {
+    console.log('🚀 开始演示 MCP Streamable HTTP 功能...\n');
+    try {
+        // 1. 健康检查
+        console.log('🏥 健康检查');
+        const healthResponse = await fetch(`${BASE_URL}/health`);
+        const health = await healthResponse.json();
+        console.log('   ✅', health.message);
+        console.log('   📋 协议:', health.protocol);
+        // 2. 获取服务信息
+        console.log('\n📊 服务信息');
+        const infoResponse = await fetch(`${BASE_URL}/`);
+        const info = await infoResponse.json();
+        console.log('   ✅ 服务名称:', info.name);
+        console.log('   🔄 模式:', info.features.stateful ? '有状态' : '无状态');
+        console.log('   🛠️ 工具数量:', info.features.toolCount);
+        if (info.features.stateful) {
+            // 有状态模式示例
+            console.log('\n🔗 有状态模式演示');
+            const sessionId = await initializeSession();
+            await listTools(sessionId);
+            await callToolExample(sessionId);
+            await sessionManagementExample();
+        }
+        else {
+            // 无状态模式示例
+            console.log('\n🔗 无状态模式演示');
+            await statelessModeExample();
+        }
+        console.log('\n🎉 Streamable HTTP 功能演示完成！');
+        console.log('\n💡 Streamable HTTP 的优势:');
+        console.log('   ⚡ 更快的响应速度（无长连接开销）');
+        console.log('   🔄 更好的负载均衡支持');
+        console.log('   🌐 更简单的网络配置');
+        console.log('   📱 更好的移动设备兼容性');
+        console.log('   🔧 更容易的客户端实现');
+        console.log('\n📚 更多信息:');
+        console.log(`   API文档: ${BASE_URL}/api/docs (如果可用)`);
+        console.log(`   健康检查: ${BASE_URL}/health`);
+        console.log(`   MCP端点: ${BASE_URL}/mcp`);
+    }
+    catch (error) {
+        console.error('\n❌ Streamable HTTP 演示过程中发生错误:', error.message);
+        console.log('\n🔧 排查步骤:');
+        console.log('   1. 检查 Streamable HTTP 服务器是否已启动');
+        console.log('   2. 检查端口 3001 是否正确');
+        console.log('   3. 检查网络连接');
+        console.log('   4. 确认服务器运行在正确的模式（有状态/无状态）');
+    }
+}
+/**
+ * 显示 cURL 示例
+ */
+function showCurlExamples() {
+    console.log('\n📝 cURL 使用示例:');
+    console.log('');
+    console.log('# 健康检查');
+    console.log(`curl -X GET ${BASE_URL}/health`);
+    console.log('');
+    console.log('# 初始化会话');
+    console.log(`curl -X POST ${BASE_URL}/mcp \\`);
+    console.log('  -H "Content-Type: application/json" \\');
+    console.log('  -d \'{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{"tools":{}},"clientInfo":{"name":"curl-client","version":"1.0.0"}},"id":1}\'');
+    console.log('');
+    console.log('# 获取工具列表（需要会话ID）');
+    console.log(`curl -X POST ${BASE_URL}/mcp \\`);
+    console.log('  -H "Content-Type: application/json" \\');
+    console.log('  -H "Mcp-Session-Id: YOUR_SESSION_ID" \\');
+    console.log('  -d \'{"jsonrpc":"2.0","method":"tools/list","params":{},"id":2}\'');
+    console.log('');
+    console.log('# 调用工具（需要会话ID）');
+    console.log(`curl -X POST ${BASE_URL}/mcp \\`);
+    console.log('  -H "Content-Type: application/json" \\');
+    console.log('  -H "Mcp-Session-Id: YOUR_SESSION_ID" \\');
+    console.log('  -d \'{"jsonrpc":"2.0","method":"tools/call","params":{"name":"get_system_info","arguments":{}},"id":3}\'');
+}
+// 如果直接运行此文件
+if (import.meta.url === `file://${process.argv[1]}`) {
+    // 检查是否安装了 fetch
+    if (typeof fetch === 'undefined') {
+        console.log('⚠️ 此示例需要 Node.js 18+ 或安装 node-fetch');
+        console.log('如果您使用的是 Node.js 18 以下版本，请安装: npm install node-fetch');
+        console.log('然后在文件顶部添加: import fetch from "node-fetch";');
+        console.log('');
+        showCurlExamples();
+        process.exit(0);
+    }
+    runStreamableExamples().catch(error => {
+        console.error('运行示例失败:', error);
+        showCurlExamples();
+    });
+}
+export {};
+//# sourceMappingURL=streamable-examples.js.map

package/dist/mcp/streamable-server.js

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+/**
+ * 微信聊天数据 MCP Streamable HTTP 服务器入口文件
+ *
+ * 这是一个基于最新 MCP Streamable HTTP 传输协议的服务器，
+ * 替代了已弃用的 SSE (Server-Sent Events) 传输方式。
+ *
+ * 使用方法:
+ * node streamable-server.js [port] [--stateless] [--no-cors]
+ *
+ * 参数说明:
+ * - port: 服务器端口（默认 3001）
+ * - --stateless: 启用无状态模式（默认有状态）
+ * - --no-cors: 禁用 CORS（默认启用）
+ * - --no-json: 禁用 JSON 响应模式（默认启用）
+ *
+ * 示例:
+ * node streamable-server.js 3001 --stateless
+ */
+import ChatMcpStreamableServer from './src/mcp/streamable-server.js';
+function parseArguments() {
+    const args = process.argv.slice(2);
+    const options = {
+        port: 3001,
+        stateful: true,
+        enableCors: true,
+        enableJsonResponse: true
+    };
+    // 解析端口
+    const portArg = args.find(arg => !arg.startsWith('--') && !isNaN(parseInt(arg)));
+    if (portArg) {
+        options.port = parseInt(portArg);
+    }
+    // 解析选项
+    if (args.includes('--stateless')) {
+        options.stateful = false;
+    }
+    if (args.includes('--no-cors')) {
+        options.enableCors = false;
+    }
+    if (args.includes('--no-json')) {
+        options.enableJsonResponse = false;
+    }
+    return options;
+}
+async function main() {
+    const options = parseArguments();
+    console.log('🚀 正在启动微信聊天数据 MCP Streamable HTTP 服务器...');
+    console.log(`📍 端口: ${options.port}`);
+    console.log(`🔄 模式: ${options.stateful ? '有状态' : '无状态'}`);
+    console.log(`🌐 CORS: ${options.enableCors ? '启用' : '禁用'}`);
+    console.log(`📝 JSON响应: ${options.enableJsonResponse ? '启用' : '禁用'}`);
+    console.log('');
+    try {
+        const server = new ChatMcpStreamableServer(options.port, {
+            stateful: options.stateful,
+            enableCors: options.enableCors,
+            enableJsonResponse: options.enableJsonResponse
+        });
+        await server.start();
+    }
+    catch (error) {
+        console.error('❌ 启动服务器失败:', error.message);
+        console.log('\n🔧 常见解决方案:');
+        console.log('   1. 检查端口是否被占用');
+        console.log('   2. 确保数据库配置正确');
+        console.log('   3. 检查 Node.js 版本 (建议 18+)');
+        process.exit(1);
+    }
+}
+// 检查是否直接运行此文件
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main().catch((error) => {
+        console.error('启动失败:', error);
+        process.exit(1);
+    });
+}
+export default ChatMcpStreamableServer;
+//# sourceMappingURL=streamable-server.js.map

package/dist/mcp/test-mcp.js

@@ -0,0 +1,64 @@
+import ChatMcpServer from './src/mcp/server.js';
+/**
+ * MCP 服务器功能测试（不依赖数据库）
+ */
+async function testMcpServer() {
+    console.log('🧪 开始测试 MCP 服务器功能...\n');
+    try {
+        // 创建 MCP 服务器实例
+        const server = new ChatMcpServer();
+        // 检查服务器是否正确初始化
+        console.log('✅ MCP 服务器实例创建成功');
+        // 检查服务器基本属性
+        if (server.server) {
+            console.log('✅ MCP SDK 服务器初始化成功');
+        }
+        else {
+            console.log('❌ MCP SDK 服务器初始化失败');
+        }
+        // 检查服务器名称和版本
+        console.log(`✅ 服务器名称: ${server.server.name}`);
+        console.log(`✅ 服务器版本: ${server.server.version}`);
+        console.log('\n🎯 MCP 服务器基础测试完成！');
+        console.log('\n📋 可用的 MCP 工具（共18个）:');
+        console.log('   🔍 查询工具 (9个):');
+        console.log('      - search_friends, search_groups, search_messages');
+        console.log('      - full_text_search, get_robot_statistics');
+        console.log('      - get_conversation_details, get_group_members_detail');
+        console.log('      - get_message_heatmap, get_system_info');
+        console.log('   📊 分析工具 (5个):');
+        console.log('      - quick_find, analyze_relationships');
+        console.log('      - analyze_activity, analyze_content, export_data');
+        console.log('   💾 数据写入工具 (4个):');
+        console.log('      - batch_create_friends, batch_create_groups');
+        console.log('      - batch_create_group_members, create_chat_message');
+        console.log('\n🚀 启动服务器:');
+        console.log('   npm run mcp:server');
+        console.log('   或: node mcp-server.js');
+        console.log('\n🔌 Claude Desktop 配置:');
+        console.log('   配置文件位置: ~/Library/Application Support/Claude/claude_desktop_config.json');
+        console.log('   添加配置:');
+        console.log('   {');
+        console.log('     "mcpServers": {');
+        console.log('       "chat-mcp": {');
+        console.log('         "command": "node",');
+        console.log(`         "args": ["${process.cwd()}/mcp-server.js"]`);
+        console.log('       }');
+        console.log('     }');
+        console.log('   }');
+        console.log('\n💡 注意事项:');
+        console.log('   - 使用前请确保 PostgreSQL 数据库已启动');
+        console.log('   - 需要先运行数据库迁移: npm run db:migrate');
+        console.log('   - 配置数据库连接信息在 src/config/database.js');
+    }
+    catch (error) {
+        console.error('❌ MCP 服务器测试失败:', error.message);
+        console.log('\n🔧 可能的解决方案:');
+        console.log('   1. 检查 Node.js 版本 (建议 18+)');
+        console.log('   2. 重新安装依赖: npm install');
+        console.log('   3. 检查文件路径是否正确');
+    }
+}
+// 运行测试
+testMcpServer();
+//# sourceMappingURL=test-mcp.js.map

package/dist/mcp/test-streamable-server.js

@@ -0,0 +1,86 @@
+import ChatMcpStreamableServer from './src/mcp/streamable-server.js';
+/**
+ * Streamable HTTP 服务器功能测试
+ */
+async function testStreamableServer() {
+    console.log('🧪 开始测试 MCP Streamable HTTP 服务器功能...\n');
+    try {
+        // 测试有状态模式
+        console.log('1️⃣ 测试有状态模式');
+        const statefulServer = new ChatMcpStreamableServer(3002, {
+            stateful: true,
+            enableJsonResponse: true,
+            enableCors: true
+        });
+        console.log('   ✅ 有状态服务器实例创建成功');
+        // 测试无状态模式
+        console.log('\n2️⃣ 测试无状态模式');
+        const statelessServer = new ChatMcpStreamableServer(3003, {
+            stateful: false,
+            enableJsonResponse: true,
+            enableCors: true
+        });
+        console.log('   ✅ 无状态服务器实例创建成功');
+        // 测试工具注册
+        console.log('\n3️⃣ 测试工具注册');
+        try {
+            const mcpServer = statefulServer.createMcpServer();
+            // 检查工具是否注册成功 - MCP SDK的tools属性可能不同
+            const hasTools = mcpServer && (mcpServer.tools || mcpServer._tools || mcpServer.handlers);
+            console.log(`   ✅ MCP 服务器创建成功，工具注册状态: ${hasTools ? '已注册' : '未注册'}`);
+        }
+        catch (error) {
+            console.log('   ⚠️ 工具注册测试失败（可能是依赖问题）:', error.message);
+        }
+        console.log('\n🎯 Streamable HTTP 服务器基础测试完成！');
+        console.log('\n📋 新的 Streamable HTTP 特性:');
+        console.log('   🔄 支持有状态和无状态两种模式');
+        console.log('   📝 原生 JSON 响应支持');
+        console.log('   🔗 标准 HTTP 请求/响应，无需长连接');
+        console.log('   🚀 更好的负载均衡和横向扩展支持');
+        console.log('   ⚡ 比 SSE 更高效的传输方式');
+        console.log('\n🚀 启动命令:');
+        console.log('   # 有状态模式（默认）');
+        console.log('   npm run streamable:server');
+        console.log('   ');
+        console.log('   # 无状态模式');
+        console.log('   npm run streamable:server:stateless');
+        console.log('   ');
+        console.log('   # 开发模式（自动重启）');
+        console.log('   npm run streamable:server:dev');
+        console.log('   ');
+        console.log('   # 自定义选项');
+        console.log('   node streamable-server.js 3001 --stateless --no-cors');
+        console.log('\n🔗 API 端点:');
+        console.log('   MCP 端点: POST http://localhost:3001/mcp');
+        console.log('   健康检查: GET http://localhost:3001/health');
+        console.log('   服务信息: GET http://localhost:3001/');
+        console.log('   删除会话: DELETE http://localhost:3001/mcp (仅有状态模式)');
+        console.log('\n💡 与 SSE 版本的区别:');
+        console.log('   ❌ 不再需要长连接');
+        console.log('   ❌ 不再需要 SSE 事件流');
+        console.log('   ✅ 每个请求都是独立的 HTTP 请求');
+        console.log('   ✅ 更简单的客户端实现');
+        console.log('   ✅ 更好的网络兼容性');
+        console.log('   ✅ 更容易的负载均衡');
+        console.log('\n📚 MCP 客户端连接示例:');
+        console.log('   ```javascript');
+        console.log('   import { Client } from "@modelcontextprotocol/sdk/client/index.js";');
+        console.log('   import { HTTPTransport } from "@modelcontextprotocol/sdk/client/http.js";');
+        console.log('   ');
+        console.log('   const transport = new HTTPTransport("http://localhost:3001/mcp");');
+        console.log('   const client = new Client({ name: "my-app", version: "1.0.0" }, {});');
+        console.log('   await client.connect(transport);');
+        console.log('   ```');
+    }
+    catch (error) {
+        console.error('❌ Streamable HTTP 服务器测试失败:', error.message);
+        console.log('\n🔧 可能的解决方案:');
+        console.log('   1. 检查 MCP SDK 版本是否为最新');
+        console.log('   2. 检查 Node.js 版本 (建议 18+)');
+        console.log('   3. 重新安装依赖: npm install');
+    }
+}
+// 运行测试
+testStreamableServer();
+//# sourceMappingURL=test-streamable-server.js.map

package/dist/package-json.js

@@ -0,0 +1,89 @@
+/**
+ * This file was auto generated from scripts/generate-version.sh
+ */
+export const packageJson = {
+    "name": "wechaty-web-panel",
+    "version": "1.6.113",
+    "exports": {
+        ".": {
+            "import": "./dist/index.js"
+        }
+    },
+    "type": "module",
+    "scripts": {
+        "build": "tsc -p tsconfig.json",
+        "clean": "shx rm -fr dist/*",
+        "dist": "npm run clean && npm run build",
+        "test:wechat": "node test/wechat.js",
+        "test:wework": "node test/wework.js",
+        "release": "verpub publish",
+        "release:dry": "verpub --dry-run",
+        "db:migrate": "node src/mcp/src/scripts/migrate.js"
+    },
+    "devDependencies": {
+        "typescript": "^5.4",
+        "@chatie/semver": "^0.4.7",
+        "@chatie/tsconfig": "^4.6.3",
+        "@grpc/grpc-js": "1.9.14",
+        "@juzi/wechaty": "^1.0.108",
+        "@juzi/wechaty-puppet": "^1.0.100",
+        "@juzi/wechaty-puppet-service": "^1.0.105",
+        "babel-eslint": "^10.1.0",
+        "eslint": "^7.4.0",
+        "eslint-config-prettier": "^6.11.0",
+        "eslint-plugin-prettier": "^3.1.4",
+        "npm-run-all": "^4.1.5",
+        "prettier": "^2.0.5",
+        "wechaty-puppet-matrix": "^0.0.34",
+        "wechaty-puppet-wechat4u": "^1.14.12",
+        "tsup": "^8.5.1"
+    },
+    "readme": "README.md",
+    "engines": {
+        "node": ">=16",
+        "npm": ">=7"
+    },
+    "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.17.0",
+        "cors": "^2.8.5",
+        "dotenv": "^16.3.0",
+        "express": "^5.1.0",
+        "pg": "^8.11.0",
+        "pg-hstore": "^2.3.4",
+        "sequelize": "^6.37.0",
+        "zod": "^3.25.76",
+        "zod-to-json-schema": "^3.24.6",
+        "@aws-sdk/client-s3": "^3.828.0",
+        "@coze/api": "^1.0.19",
+        "@dqbd/tiktoken": "^1.0.2",
+        "@langchain/community": "^0.3.32",
+        "@langchain/core": "^0.3.40",
+        "@langchain/openai": "^0.4.4",
+        "@langchain/redis": "^0.1.1",
+        "ali-oss": "^6.21.0",
+        "axios": "1.8.2",
+        "baidu-aip-sdk": "^4.16.10",
+        "dayjs": "^1.11.7",
+        "eventsource-parser": "^1.0.0",
+        "form-data": "^4.0.0",
+        "https-proxy-agent": "^5.0.1",
+        "jsonwebtoken": "^9.0.2",
+        "keyv": "^4.5.2",
+        "langchain": "^0.3.19",
+        "mqtt": "^4.2.6",
+        "mustache": "^4.2.0",
+        "nedb": "^1.8.0",
+        "node-fetch": "^2.6.9",
+        "node-schedule": "^1.3.2",
+        "qrcode-terminal": "^0.12.0",
+        "rss-parser": "^3.13.0",
+        "superagent": "^5.3.1",
+        "uuid": "^9.0.0"
+    },
+    "publishConfig": {
+        "registry": " https://registry.npmjs.org/",
+        "tag": "latest",
+        "access": "public"
+    }
+};
+//# sourceMappingURL=package-json.js.map