feat(tools): merge getWebsiteConfig into envQuery for unified environment queries 🚀

Author: binggg

mcp/src/tools/env.ts

@@ -1,9 +1,9 @@
 import { z } from "zod";
-import { getCloudBaseManager, resetCloudBaseManagerCache } from '../cloudbase-manager.js'
-import { logout } from '../auth.js'
-import { clearUserEnvId, _promptAndSetEnvironmentId } from './interactive.js'
-import { debug } from '../utils/logger.js'
+import { logout } from '../auth.js';
+import { getCloudBaseManager, resetCloudBaseManagerCache } from '../cloudbase-manager.js';
 import { ExtendedMcpServer } from '../server.js';
+import { debug } from '../utils/logger.js';
+import { _promptAndSetEnvironmentId, clearUserEnvId } from './interactive.js';
 
 export function registerEnvTools(server: ExtendedMcpServer) {
   // 获取 cloudBaseOptions，如果没有则为 undefined
@@ -109,22 +109,22 @@ export function registerEnvTools(server: ExtendedMcpServer) {
     }
   );
 
-  // envQuery - 环境查询（合并 listEnvs + getEnvInfo + getEnvAuthDomains）
+  // envQuery - 环境查询（合并 listEnvs + getEnvInfo + getEnvAuthDomains + getWebsiteConfig）
   server.registerTool?.(
     "envQuery",
     {
       title: "环境查询",
-      description: "查询云开发环境相关信息，支持查询环境列表、当前环境信息和安全域名。（原工具名：listEnvs/getEnvInfo/getEnvAuthDomains，为兼容旧AI规则可继续使用这些名称）",
+      description: "查询云开发环境相关信息，支持查询环境列表、当前环境信息、安全域名和静态网站托管配置。（原工具名：listEnvs/getEnvInfo/getEnvAuthDomains/getWebsiteConfig，为兼容旧AI规则可继续使用这些名称）",
       inputSchema: {
-        action: z.enum(["list", "info", "domains"]).describe("查询类型：list=环境列表，info=当前环境信息，domains=安全域名列表")
+        action: z.enum(["list", "info", "domains", "hosting"]).describe("查询类型：list=环境列表，info=当前环境信息，domains=安全域名列表，hosting=静态网站托管配置")
       },
       annotations: {
         readOnlyHint: true,
         openWorldHint: true,
         category: "env"
       }
     },
-    async ({ action }: { action: "list" | "info" | "domains" }) => {
+    async ({ action }: { action: "list" | "info" | "domains" | "hosting" }) => {
       try {
         let result;
 
@@ -151,6 +151,11 @@ export function registerEnvTools(server: ExtendedMcpServer) {
             result = await cloudbaseDomains.env.getEnvAuthDomains();
             break;
 
+          case "hosting":
+            const cloudbaseHosting = await getManager();
+            result = await cloudbaseHosting.hosting.getWebsiteConfig();
+            break;
+
           default:
             throw new Error(`不支持的查询类型: ${action}`);
         }

mcp/src/tools/hosting.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { getCloudBaseManager } from '../cloudbase-manager.js'
+import { getCloudBaseManager } from '../cloudbase-manager.js';
 import { ExtendedMcpServer } from '../server.js';
 
 
@@ -79,32 +79,7 @@ export function registerHostingTools(server: ExtendedMcpServer) {
     }
   );
 
-  // getWebsiteConfig - 获取静态网站托管配置
-  server.registerTool?.(
-    "getWebsiteConfig",
-    {
-      title: "查询静态托管配置",
-      description: "获取静态网站托管配置",
-      inputSchema: {},
-      annotations: {
-        readOnlyHint: true,
-        openWorldHint: true,
-        category: "hosting"
-      }
-    },
-    async () => {
-      const cloudbase = await getManager()
-      const result = await cloudbase.hosting.getWebsiteConfig();
-      return {
-        content: [
-          {
-            type: "text",
-            text: JSON.stringify(result, null, 2)
-          }
-        ]
-      };
-    }
-  );
+
 
   // deleteFiles - 删除静态网站托管文件
   server.registerTool?.(

specs/getwebsiteconfig-merge/design.md

@@ -0,0 +1,78 @@
+# 技术方案设计
+
+## 架构设计
+
+### 当前架构分析
+
+1. **envQuery 工具** (mcp/src/tools/env.ts)
+   - 位置：`mcp/src/tools/env.ts`
+   - 功能：环境相关信息查询
+   - 当前支持的操作：
+     - `list`: 获取环境列表
+     - `info`: 获取当前环境信息
+     - `domains`: 获取安全域名列表
+
+2. **getWebsiteConfig 工具** (mcp/src/tools/hosting.ts)
+   - 位置：`mcp/src/tools/hosting.ts`
+   - 功能：获取静态网站托管配置
+   - 当前实现：调用 `cloudbase.hosting.getWebsiteConfig()`
+
+### 合并方案
+
+#### 方案选择：扩展 envQuery
+选择将 getWebsiteConfig 合并到 envQuery 中，因为：
+- 静态网站托管配置属于环境信息的一部分
+- 减少工具数量，提高 API 一致性
+- 符合工具合并的最佳实践
+
+#### 合并后的架构
+
+```
+envQuery (扩展后)
+├── action: "list" → env.listEnvs()
+├── action: "info" → env.getEnvInfo()
+├── action: "domains" → env.getEnvAuthDomains()
+└── action: "hosting" → hosting.getWebsiteConfig() [新增]
+```
+
+## 技术栈
+
+- **语言**：TypeScript
+- **框架**：MCP Server
+- **验证**：Zod schema validation
+- **CloudBase SDK**：用于云开发环境操作
+
+## 数据库/接口设计
+
+### 输入接口设计
+
+```typescript
+// 扩展后的 envQuery 输入接口
+interface EnvQueryInput {
+  action: "list" | "info" | "domains" | "hosting"; // 新增 "hosting"
+}
+```
+
+### 输出接口设计
+
+保持现有输出格式不变：
+```typescript
+interface EnvQueryOutput {
+  content: Array<{
+    type: "text";
+    text: string; // JSON.stringify(result, null, 2)
+  }>;
+}
+```
+
+## 测试策略
+
+1. **单元测试**：测试新增的 "hosting" action
+2. **集成测试**：验证与其他 action 的兼容性
+3. **回归测试**：确保原有功能不受影响
+
+## 安全性和性能考虑
+
+- **安全性**：保持现有的权限验证机制
+- **性能**：合并后减少网络请求次数，提高查询效率
+- **向后兼容**：保留原有 API 不变

specs/getwebsiteconfig-merge/requirements.md

@@ -0,0 +1,18 @@
+# 需求文档
+
+## 介绍
+
+将独立的 `getWebsiteConfig` 工具合并到现有的 `envQuery` 工具中，实现环境相关查询功能的统一管理。
+
+## 需求
+
+### 需求 1 - 合并工具功能
+
+**用户故事：** 作为开发者，我希望将静态网站托管配置查询功能合并到 envQuery 工具中，以便在同一个工具内完成所有环境相关信息的查询。
+
+#### 验收标准
+
+1. envQuery 工具支持新增的 `hosting` 操作类型，用于查询静态网站托管配置
+2. getWebsiteConfig 工具从 hosting.ts 中移除，避免功能重复
+3. 合并后的工具保持原有功能的完整性，不影响现有用户的正常使用
+4. 合并后的 API 设计合理，符合工具合并的最佳实践

specs/getwebsiteconfig-merge/tasks.md

@@ -0,0 +1,29 @@
+# 实施计划
+
+- [ ] 1. 更新 envQuery 输入模式
+  - 在 envQuery 的 inputSchema 中添加 "hosting" 操作类型
+  - 更新工具描述，说明新增的静态网站配置查询功能
+  - _需求: 合并工具功能
+
+- [ ] 2. 实现静态网站配置查询逻辑
+  - 在 envQuery 的 switch 语句中添加 "hosting" case
+  - 调用 cloudbase.hosting.getWebsiteConfig() 方法
+  - 保持与其他操作一致的错误处理和返回格式
+  - _需求: 合并工具功能
+
+- [ ] 3. 从 hosting.ts 移除 getWebsiteConfig 工具
+  - 删除 getWebsiteConfig 工具的注册代码
+  - 清理相关的注释和接口定义
+  - 确保不影响其他 hosting 相关工具
+  - _需求: 合并工具功能
+
+- [ ] 4. 更新文档和类型定义
+  - 更新工具的描述文档，说明合并后的功能
+  - 确保类型定义的一致性
+  - _需求: 合并工具功能
+
+- [ ] 5. 验证合并后的功能
+  - 测试 envQuery 的 "hosting" 操作是否正常工作
+  - 验证原有功能不受影响
+  - 确认向后兼容性
+  - _需求: 合并工具功能