@codify-ai/mcp-client 1.0.0 → 1.0.2

package/mcp-client.js

@@ -6,25 +6,26 @@
  * 
  * 使用方法：
  * 在 Cursor 配置 (~/.cursor/mcp.json) 中：
- * {
- *   "mcpServers": {
- *     "codify": {
- *       "command": "npx",
- *       "args": ["-y", "@codify/mcp-client", "--url=http://your-server:8080"],
- *       "env": {
- *         "CODIFY_ACCESS_KEY": "sk-your-access-key"
- *       }
- *     }
- *   }
- * }
+  {
+    "mcpServers": {
+      "codify": {
+        "command": "npx",
+        "args": ["-y", "@codify/mcp-client", "--url=http://your-server:8080"],
+        "env": {
+          "CODIFY_ACCESS_KEY": "sk-your-access-key"
+        }
+      }
+    }
+  }
  */
 
 import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
 
 function parseArgs() {
   const args = process.argv.slice(2);
-  let serverUrl = process.env.CODIFY_SERVER_URL || 'http://localhost:8080';
+  let serverUrl = process.env.CODIFY_SERVER_URL || 'https://mcp.codify-api.com';
   
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
@@ -150,7 +151,42 @@ mcpServer.registerResource(
   async (uri, variables) => {
     try {
       // 从 variables 中获取 channelId（由 SDK 解析）
-      const channelId = variables.channelId || uri.hostname;
+      // 如果 variables 为空或没有 channelId，尝试从 URI 解析
+      let channelId = variables?.channelId;
+      
+      if (!channelId) {
+        // 尝试从 URI hostname 获取（codify://my-demo/current -> my-demo）
+        channelId = uri.hostname;
+      }
+      
+      // 如果还是为空，尝试从 pathname 解析（备用方案）
+      if (!channelId && uri.pathname) {
+        const pathParts = uri.pathname.split('/').filter(p => p);
+        if (pathParts.length > 0) {
+          channelId = pathParts[0];
+        }
+      }
+      
+      if (!channelId) {
+        console.error(`❌ 无法从 URI 解析 channelId: ${uri.href}`);
+        console.error(`   variables:`, variables);
+        return {
+          contents: [{
+            uri: uri.href,
+            text: `// 错误: 无法解析频道 ID\n// URI: ${uri.href}\n// 请使用格式: codify://channelId/current`
+          }]
+        };
+      }
+      
+      if (process.env.DEBUG) {
+        console.error(`[DEBUG] 获取资源: ${uri.href}`);
+        console.error(`[DEBUG] variables:`, variables);
+        console.error(`[DEBUG] uri.hostname:`, uri.hostname);
+        console.error(`[DEBUG] uri.pathname:`, uri.pathname);
+        console.error(`[DEBUG] 解析的 channelId: ${channelId}`);
+        console.error(`[DEBUG] SERVER_URL: ${SERVER_URL}`);
+        console.error(`[DEBUG] ACCESS_KEY: ${ACCESS_KEY ? ACCESS_KEY.substring(0, 10) + '...' : '未设置'}`);
+      }
       
       // 添加认证头
       const headers = {};
@@ -159,45 +195,109 @@ mcpServer.registerResource(
       }
       
       // 通过 HTTP API 从远程服务器获取数据
-      const response = await fetch(`${SERVER_URL}/api/channel/${channelId}`, { headers });
+      const apiUrl = `${SERVER_URL}/api/channel/${channelId}`;
+      if (process.env.DEBUG) {
+        console.error(`[DEBUG] 请求 URL: ${apiUrl}`);
+      }
+      
+      let response;
+      try {
+        response = await fetch(apiUrl, { headers });
+      } catch (fetchError) {
+        const errorMsg = fetchError instanceof Error ? fetchError.message : String(fetchError);
+        console.error(`❌ 网络请求失败: ${errorMsg}`);
+        console.error(`   服务器 URL: ${SERVER_URL}`);
+        console.error(`   请检查: 1) 服务器是否运行 2) URL 是否正确 3) 网络连接`);
+        return {
+          contents: [{
+            uri: uri.href,
+            text: `// 网络错误: ${errorMsg}\n// 服务器: ${SERVER_URL}\n// 请检查服务器地址和网络连接`
+          }]
+        };
+      }
       
       if (!response.ok) {
-        // 如果 API 返回错误，尝试从 channels 列表中查找
-        const channelsResponse = await fetch(`${SERVER_URL}/channels`, { headers });
-        
-        if (!channelsResponse.ok) {
-          return {
-            contents: [{
-              uri: uri.href,
-              text: `// 认证失败或服务器错误 (${channelsResponse.status})`
-            }]
-          };
-        }
-        
-        const channels = await channelsResponse.json();
-        const channel = channels.find(ch => ch.channelId === channelId);
+        const errorText = await response.text().catch(() => '无法读取错误信息');
+        console.error(`❌ API 请求失败: ${response.status} ${response.statusText}`);
+        console.error(`   错误详情: ${errorText}`);
         
-        if (!channel) {
+        // 如果 API 返回错误，尝试从 channels 列表中查找
+        try {
+          const channelsResponse = await fetch(`${SERVER_URL}/channels`, { headers });
+          
+          if (!channelsResponse.ok) {
+            const channelsErrorText = await channelsResponse.text().catch(() => '无法读取错误信息');
+            console.error(`❌ 获取频道列表失败: ${channelsResponse.status}`);
+            console.error(`   错误详情: ${channelsErrorText}`);
+            return {
+              contents: [{
+                uri: uri.href,
+                text: `// 认证失败或服务器错误 (${channelsResponse.status})\n// 错误: ${channelsErrorText}\n// 请检查 CODIFY_ACCESS_KEY 是否正确`
+              }]
+            };
+          }
+          
+          const channels = await channelsResponse.json();
+          const channel = channels.find(ch => ch.channelId === channelId);
+          
+          if (!channel) {
+            return {
+              contents: [{
+                uri: uri.href,
+                text: `// 通道 ${channelId} 不存在或为空\n// 可用通道: ${channels.map(ch => ch.channelId).join(', ') || '无'}`
+              }]
+            };
+          }
+          
+          // 通道存在但第一次获取失败，再次尝试获取代码
+          console.error(`⚠️  第一次获取失败，但通道存在，再次尝试获取代码...`);
+          try {
+            const retryResponse = await fetch(`${SERVER_URL}/api/channel/${channelId}`, { headers });
+            if (retryResponse.ok) {
+              const retryData = await retryResponse.json();
+              console.log(`✅ 重试成功，获取到代码`);
+              return {
+                contents: [{
+                  uri: uri.href,
+                  text: retryData.code || "// 等待 Figma WebSocket..."
+                }]
+              };
+            } else {
+              const retryErrorText = await retryResponse.text().catch(() => '无法读取错误信息');
+              console.error(`❌ 重试仍然失败: ${retryResponse.status}`);
+              return {
+                contents: [{
+                  uri: uri.href,
+                  text: `// 通道 ${channelId} 存在但无法获取代码 (${retryResponse.status})\n// 代码长度: ${channel.codeLength} 字符\n// 最后更新: ${channel.lastUpdate}\n// 错误: ${retryErrorText}`
+                }]
+              };
+            }
+          } catch (retryError) {
+            console.error(`❌ 重试请求异常:`, retryError);
+            return {
+              contents: [{
+                uri: uri.href,
+                text: `// 通道 ${channelId} 存在但获取代码失败\n// 代码长度: ${channel.codeLength} 字符\n// 最后更新: ${channel.lastUpdate}\n// 错误: ${retryError instanceof Error ? retryError.message : String(retryError)}`
+              }]
+            };
+          }
+        } catch (channelsError) {
+          console.error(`❌ 获取频道列表异常:`, channelsError);
           return {
             contents: [{
               uri: uri.href,
-              text: `// 通道 ${channelId} 不存在或为空`
+              text: `// 获取频道列表失败: ${channelsError instanceof Error ? channelsError.message : String(channelsError)}\n// 原始错误: ${response.status} ${errorText}`
             }]
           };
         }
-        
-        // 需要从完整数据中获取代码
-        // 这里返回一个提示，因为我们没有直接的 API
-        return {
-          contents: [{
-            uri: uri.href,
-            text: `// 通道 ${channelId} 存在\n// 代码长度: ${channel.codeLength} 字符\n// 最后更新: ${channel.lastUpdate}`
-          }]
-        };
       }
       
       const data = await response.json();
       
+      if (process.env.DEBUG) {
+        console.error(`[DEBUG] 成功获取代码，长度: ${data.code?.length || 0} 字符`);
+      }
+      
       return {
         contents: [{
           uri: uri.href,
@@ -205,11 +305,15 @@ mcpServer.registerResource(
         }]
       };
     } catch (error) {
-      console.error(`❌ 获取资源失败:`, error);
+      const errorMsg = error instanceof Error ? error.message : String(error);
+      console.error(`❌ 获取资源失败:`, errorMsg);
+      if (error.stack && process.env.DEBUG) {
+        console.error(`   堆栈:`, error.stack);
+      }
       return {
         contents: [{
           uri: uri.href,
-          text: `// 错误: ${error.message}`
+          text: `// 错误: ${errorMsg}\n// URI: ${uri.href}\n// 服务器: ${SERVER_URL}`
         }]
       };
     }
@@ -222,19 +326,36 @@ mcpServer.registerTool(
   {
     description: "从 Codify 服务器获取指定频道的代码",
     inputSchema: {
-      type: "object",
-      properties: {
-        channelId: {
-          type: "string",
-          description: "频道 ID，例如: my-demo, test-channel"
-        }
-      },
-      required: ["channelId"]
+      channelId: z.string().describe("频道 ID，例如: my-demo, test-channel")
     }
   },
-  async ({ channelId }) => {
+  async (args) => {
     try {
+      // 调试：打印所有参数
+      if (process.env.DEBUG) {
+        console.error(`[DEBUG] getCode 接收到的参数:`, JSON.stringify(args, null, 2));
+        console.error(`[DEBUG] args 类型:`, typeof args);
+        console.error(`[DEBUG] args 是否为对象:`, args && typeof args === 'object');
+        console.error(`[DEBUG] args 的键:`, args ? Object.keys(args) : 'null');
+      }
+      
+      // 从参数中获取 channelId
+      const channelId = args?.channelId;
+      
       console.error(`[Tool] getCode 被调用: channelId=${channelId}`);
+      console.error(`[Tool] 原始 args:`, args);
+      
+      if (!channelId) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `❌ 参数错误: 未提供 channelId\n\n💡 请使用格式: getCode({ channelId: "my-demo" })\n\n📋 调试信息:\n- args: ${JSON.stringify(args)}\n- args 类型: ${typeof args}`
+            }
+          ],
+          isError: true
+        };
+      }
       
       // 添加认证头
       const headers = {};
@@ -298,7 +419,8 @@ mcpServer.registerTool(
 mcpServer.registerTool(
   "listChannels",
   {
-    description: "列出 Codify 服务器上所有可用的频道"
+    description: "列出 Codify 服务器上所有可用的频道",
+    inputSchema: {}
   },
   async () => {
     try {
@@ -358,7 +480,15 @@ mcpServer.registerTool(
 );
 
 // 连接 stdio 传输
-const transport = new StdioServerTransport();
-await mcpServer.connect(transport);
-
-console.error('✅ MCP 客户端已启动');
+try {
+  const transport = new StdioServerTransport();
+  await mcpServer.connect(transport);
+  console.error('✅ MCP 客户端已启动');
+} catch (error) {
+  console.error('❌ MCP 客户端启动失败:', error.message);
+  console.error('💡 请检查:');
+  console.error('   1. 服务器地址是否正确:', SERVER_URL);
+  console.error('   2. 服务器是否正在运行');
+  console.error('   3. 网络连接是否正常');
+  process.exit(1);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codify-ai/mcp-client",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Codify MCP 客户端 - 连接到远程 Codify MCP 服务器，供 Cursor 等 IDE 使用",
   "type": "module",
   "bin": {
@@ -15,6 +15,17 @@
     "node": ">=18.0.0",
     "npm": ">=8.0.0"
   },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx watch src/index.ts",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "prepare": "npm run build",
+    "mcp-client": "node mcp-client.js",
+    "publish:client": "bash script/publish.sh",
+    "build:deploy": "bash script/build-deploy.sh"
+  },
   "keywords": [
     "mcp",
     "model-context-protocol",