@becrafter/prompt-manager 0.0.19 → 0.1.2

package/packages/server/mcp/mcp.server.js

@@ -5,8 +5,13 @@ import {
     handleGetPrompt,
     handleSearchPrompts,
     handleReloadPrompts
-} from './mcp.handler.js';
-import { handleToolX } from './toolx.handler.js';
+} from './prompt.handler.js';
+import { handleToolM } from '../toolm/index.js';
+import { handleSequentialThinking } from './sequential-thinking.handler.js';
+import { handleThinkPlan } from './think-plan.handler.js';
+// import { generateToolmDescription } from '../toolm/tool-description-generator.service.js';
+import { generateToolmDescription } from '../toolm/tool-description-generator-optimized.service.js';
+import { toolLoaderService } from '../toolm/tool-loader.service.js';
 
 class Server {
     constructor() {
@@ -36,8 +41,22 @@ class Server {
     }
 }
 
-export const getMcpServer = () => {
+export const getMcpServer = async () => {
     const mcpServer = new Server();
+    
+    // 确保工具加载器已初始化（用于生成动态描述）
+    if (!toolLoaderService.initialized) {
+        try {
+            await toolLoaderService.initialize();
+        } catch (error) {
+            // 如果初始化失败，继续使用默认描述
+            console.warn('工具加载器初始化失败，使用默认描述:', error.message);
+        }
+    }
+    
+    // 动态生成 toolm 工具的描述
+    const toolmDescription = generateToolmDescription();
+    
     mcpServer.registerTools([
         {
             name: 'search_prompts',
@@ -60,112 +79,312 @@ export const getMcpServer = () => {
             }
         },
         {
-            name: 'toolx',
-            description: `ToolX is the Prompt Manager tool runtime for loading and executing various tools.
-
-## Why ToolX Exists
-
-ToolX is your gateway to the Prompt Manager tool ecosystem. Think of it as:
-- A **universal remote control** for all Prompt Manager tools
-- Your **interface** to specialized capabilities (file operations, etc.)
-- The **bridge** between you (AI agent) and powerful system tools
-
-Without ToolX, you cannot access any Prompt Manager ecosystem tools.
-
-## When to Use ToolX
-
-### Common Scenarios (IF-THEN rules):
-- IF user needs file operations → USE tool://filesystem via toolx
-- IF you see tool:// in any context → USE toolx to call it
-
-### First Time Using Any Tool
-⚠️ **MUST run mode: manual first** to read the tool's documentation
-⚠️ Example: toolx with mode: manual for tool://filesystem
-
-## How to Use ToolX (Copy These Patterns)
-
-### Pattern 1: Read Tool Manual (First Time)
-
-**Exact code to use:**
-\`\`\`javascript
-// Call the toolx function with this exact structure:
-toolx({
-  yaml: \`tool: tool://filesystem\nmode: manual\`
-})
-\`\`\`
-
-**What this does:** Shows you how to use the filesystem tool
-
-### Pattern 2: Execute Tool with Parameters
-
-**Exact code to use:**
-\`\`\`javascript
-toolx({
-  yaml: \`tool: tool://filesystem\nmode: execute\nparameters:\n  path: /path/to/file.txt\n  action: read\`
-})
-\`\`\`
-
-**What this does:** Reads a file at the specified path
-
-### Pattern 3: Configure Tool Environment
-
-**Exact code to use:**
-\`\`\`javascript
-toolx({
-  yaml: \`tool: tool://my-tool\nmode: configure\nparameters:\n  API_KEY: sk-xxx123\n  TIMEOUT: 30000\`
-})
-\`\`\`
-
-**What this does:** Sets environment variables for the tool
-
-## Critical Rules (Must Follow)
-
-### ✅ Correct Format
-The yaml parameter MUST be a complete YAML document:
-- Start with \`tool: tool://tool-name\`
-- Add \`mode: execute\` (or manual/configure)
-- If needed, add \`parameters:\` section with proper indentation
-
-### ❌ Common Mistakes to Avoid
-- DON'T pass just "tool://filesystem" (missing YAML structure)
-- DON'T add @ prefix like "@tool://filesystem" (system handles it)
-- DON'T forget "tool://" prefix (not "tool: filesystem")
-- DON'T forget to read manual first for new tools
-
-## Available System Tools
-
-Quick reference of built-in tools:
-- **tool://filesystem** - File operations (read/write/list/delete)
-
-To see all available tools: check the tools directory
-
-## Step-by-Step Workflow
-
-### Step 1: Discover Available Tools
-Check the tools directory to see what tools exist
-
-### Step 2: Read Tool Manual
-\`\`\`javascript
-toolx({
-  yaml: \`tool: tool://TOOLNAME\nmode: manual\`
-})
-\`\`\`
-
-### Step 3: Execute Tool
-Copy the example from manual, modify parameters for your needs
-
-### Step 4: Handle Errors
-If execution fails, check:
-- Is the tool name correct?
-- Are parameters properly indented?
-- Did you read the manual first?
-
-`,
+            name: 'toolm',
+            description: toolmDescription,
             inputSchema: {
                 yaml: z.string().describe('YAML 格式的工具调用配置')
             },
             handler: async (args) => {
-                return handleToolX(args);
+                return handleToolM(args);
+            }
+        },
+        {
+            name: 'sequentialthinking',
+            description: `🧠 **顺序思考工具 (Sequential Thinking)** - 动态反思性思维工具
+
+## 🎯 工具定位
+这是一个用于**探索性、分析性、不确定性**问题的动态思考工具。支持非线性思维、修订和分支，适合需要深入分析和反复验证的场景。
+
+**重要说明：** 此工具支持 MCP 工具协调功能。模型会分析可用工具及其描述，智能推荐合适的工具，并由服务器跟踪和组织这些推荐。
+
+## 🔍 场景识别 - 何时使用此工具？
+
+### ✅ 优先使用 sequentialthinking 的场景：
+
+**1. 探索性问题（问题不明确）**
+   - ❓ "为什么系统性能下降？" → 需要分析原因
+   - ❓ "用户流失率高的原因是什么？" → 需要诊断问题
+   - ❓ "这个bug的根本原因是什么？" → 需要深入调查
+
+**2. 分析性任务（需要假设验证）**
+   - 📊 复杂数据分析
+   - 🔬 问题诊断和根因分析
+   - 🧪 假设生成和验证
+   - 📈 趋势分析和预测
+
+**3. 创意性工作（需要多路径探索）**
+   - 💡 产品功能设计
+   - 🎨 方案设计
+   - 🚀 创新思路探索
+   - 🔄 需要对比多个方案
+
+**4. 需要修订和分支的场景**
+   - 发现之前的思考有误，需要修正
+   - 需要探索多个可能的解决方案
+   - 需要回溯和重新评估
+
+**5. 需要工具指导的场景**
+   - 不确定应该使用哪些工具
+   - 需要了解工具的执行顺序
+   - 需要工具使用的参数建议
+   - 需要工具推荐的合理性说明
+
+### ❌ 不适合使用 sequentialthinking 的场景：
+   - ✅ 目标明确，只需要执行 → 使用 think_and_plan
+   - ✅ 需要具体的行动步骤 → 使用 think_and_plan
+   - ✅ 任务分解和执行规划 → 使用 think_and_plan
+
+## 🆚 工具对比决策树
+
+决策流程：
+  问题是否明确？
+  - 不明确/需要探索 → sequentialthinking
+  - 明确 + 需要执行 → think_and_plan
+  - 明确 + 只需分析 → sequentialthinking
+  - 需要工具推荐和指导 → sequentialthinking
+
+## ✨ 核心特性
+
+**1. 非线性思维**
+   - 支持分支（branch）：从某个思考点探索多个方向
+   - 支持修订（revision）：修正之前的思考
+   - 支持回溯：重新评估之前的步骤
+
+**2. 动态调整**
+   - 可以调整总思考步骤数（total_thoughts）
+   - 可以中途添加更多思考
+   - 可以表达不确定性
+   - 可以探索替代方案
+
+**3. 进度追踪**
+   - 显示思考进度（当前/总数/百分比）
+   - 自动生成最终总结
+   - 提取关键洞察和结论
+   - 跟踪已推荐的步骤和剩余步骤
+
+**4. 灵活性强**
+   - 单一 thought 字段，内容自由
+   - 支持假设生成和验证
+   - 支持问题分解和重构
+   - 支持工具推荐和参数建议
+
+**5. MCP 工具协调（核心特性）**
+   - 🔧 为每个步骤推荐合适的工具
+   - 📝 提供工具推荐的合理性说明
+   - 📋 建议工具执行顺序和参数
+   - 📊 跟踪之前的推荐和剩余步骤
+   - 🎯 分析可用工具并做出智能推荐
+
+## 📋 使用指南
+
+**参数说明：**
+
+**基础参数：**
+- \`thought\`（必需）：当前思考步骤，可以包括：
+  * 常规分析步骤
+  * 对之前思考的修订
+  * 对之前决策的质疑
+  * 意识到需要更多分析
+  * 方法的改变
+  * 假设生成
+  * 假设验证
+  * 工具推荐和合理性说明
+- \`thoughtNumber\`（可选）：当前思考编号（可以从初始总数继续增加）
+- \`totalThoughts\`（可选）：当前估计所需思考数（可动态调整）
+- \`nextThoughtNeeded\`（可选）：是否需要继续思考（即使看似已到终点）
+
+**修订和分支参数：**
+- \`isRevision\`（可选）：布尔值，表示此思考是否修订了之前的思考
+- \`revisesThought\`（可选）：如果 isRevision 为 true，指定要重新考虑的思考编号
+- \`branchFromThought\`（可选）：如果创建分支，指定分支起点的思考编号
+- \`branchId\`（可选）：当前分支的标识符（如果有）
+- \`needsMoreThoughts\`（可选）：如果到达终点但意识到需要更多思考
+
+**MCP 工具协调参数：**
+- \`available_mcp_tools\`（可选）：可用 MCP 工具名称数组（例如：["mcp-omnisearch", "mcp-turso-cloud"]）
+- \`current_step\`（可选）：当前步骤推荐，包括：
+  * \`step_description\`：需要做什么
+  * \`recommended_tools\`：此步骤推荐的工具
+  * \`expected_outcome\`：此步骤的预期结果
+  * \`next_step_conditions\`：下一步需要考虑的条件
+- \`previous_steps\`（可选）：已推荐的步骤
+- \`remaining_steps\`（可选）：后续步骤的高级描述
+
+**使用流程：**
+1. 从初始估计开始，但准备随时调整
+2. 自由质疑和修订之前的思考
+3. 即使到达"终点"也可以继续添加思考
+4. 表达不确定性，探索替代方案
+5. 标记修订和分支
+6. 生成假设并验证
+7. **考虑可用工具，为当前步骤推荐合适的工具**
+8. **提供工具推荐的清晰合理性说明**
+9. **在适当时建议具体的工具参数**
+10. **考虑每个步骤的替代工具**
+11. **跟踪推荐步骤的进度**
+12. 忽略与当前步骤无关的信息
+13. 重复直到满意
+14. 只在真正完成且得到满意答案时设置 nextThoughtNeeded=false
+15. 提供单一、理想情况下正确的答案作为最终输出
+
+## 💡 典型使用示例
+
+**示例1：问题诊断（带工具推荐）**
+- Thought 1: "分析系统性能下降的可能原因"
+  - current_step: { step_description: "检查系统日志", recommended_tools: ["mcp-log-reader"], expected_outcome: "发现错误模式" }
+- Thought 2: "检查数据库查询性能"
+  - current_step: { step_description: "分析慢查询", recommended_tools: ["mcp-db-profiler"], expected_outcome: "识别性能瓶颈" }
+- Thought 3: "发现查询慢，需要进一步分析"（可能需要修订或分支）
+
+**示例2：方案设计（带工具协调）**
+- Thought 1: "设计用户登录功能"
+  - current_step: { step_description: "设计认证流程", recommended_tools: ["mcp-diagram-tool"], expected_outcome: "流程图" }
+- Thought 2: "考虑安全性要求"
+- Thought 3: "修订：需要添加双因素认证"（revision）
+  - current_step: { step_description: "实现2FA", recommended_tools: ["mcp-auth-library"], expected_outcome: "安全登录方案" }
+
+**示例3：多方案探索（带工具推荐）**
+- Thought 1: "评估三种架构方案"
+- Branch A: "方案A：微服务架构"
+  - current_step: { step_description: "评估微服务方案", recommended_tools: ["mcp-architecture-analyzer"], expected_outcome: "方案A评估报告" }
+- Branch B: "方案B：单体架构"
+  - current_step: { step_description: "评估单体方案", recommended_tools: ["mcp-architecture-analyzer"], expected_outcome: "方案B评估报告" }`,
+            inputSchema: {
+                thought: z.string().describe('Your current thinking step'),
+                nextThoughtNeeded: z.boolean().optional().describe('Whether another thought step is needed'),
+                thoughtNumber: z.number().int().min(1).optional().describe('Current thought number'),
+                totalThoughts: z.number().int().min(1).optional().describe('Estimated total thoughts needed'),
+                isRevision: z.boolean().optional().describe('Whether this revises previous thinking'),
+                revisesThought: z.number().int().min(1).optional().describe('Which thought is being reconsidered'),
+                branchFromThought: z.number().int().min(1).optional().describe('Branching point thought number'),
+                branchId: z.string().optional().describe('Branch identifier'),
+                needsMoreThoughts: z.boolean().optional().describe('If more thoughts are needed')
+            },
+            handler: async (args) => {
+                return handleSequentialThinking(args);
+            }
+        },
+        {
+            name: 'think_and_plan',
+            description: `📋 **思考规划工具 (Think & Plan)** - 结构化执行导向工具
+
+## 🎯 工具定位
+这是一个用于**目标明确、需要执行**的结构化规划工具。强调思考-计划-行动的三元结构，适合将复杂任务分解为可执行步骤并追踪执行过程。
+
+## 🔍 场景识别 - 何时使用此工具？
+
+### ✅ 优先使用 think_and_plan 的场景：
+
+**1. 任务执行（目标明确）**
+   - ✅ "实现用户登录功能" → 需要具体实现步骤
+   - ✅ "部署新版本到生产环境" → 需要执行计划
+   - ✅ "完成月度报告" → 需要任务分解
+   - ✅ "重构某个模块" → 需要实施步骤
+
+**2. 项目管理（需要行动追踪）**
+   - 📝 任务分解和步骤规划
+   - 📅 项目里程碑规划
+   - ✅ 行动项追踪
+   - 🎯 目标达成路径
+
+**3. 结构化问题（需要明确步骤）**
+   - 🔧 流程设计和实施
+   - 📊 方案执行计划
+   - 🚀 功能开发规划
+   - 🔄 系统迁移计划
+
+**4. 需要可执行行动的场景**
+   - 每个步骤都需要明确的下一步行动
+   - 需要调用具体工具或执行具体操作
+   - 需要验证和检查点
+
+### ❌ 不适合使用 think_and_plan 的场景：
+   - ❓ 问题不明确，需要探索 → 使用 sequentialthinking
+   - ❓ 需要分析原因或诊断问题 → 使用 sequentialthinking
+   - ❓ 需要多方案对比或修订 → 使用 sequentialthinking
+   - ❓ 创意性工作，需要发散思维 → 使用 sequentialthinking
+
+## 🆚 工具对比决策树
+
+决策流程：
+  问题是否明确？
+  - 明确 + 需要执行 → think_and_plan (优先选择)
+  - 明确 + 只需分析 → sequentialthinking
+  - 不明确/需要探索 → sequentialthinking
+
+## ✨ 核心特性
+
+**1. 三元结构（思考-计划-行动）**
+   - 🤔 Thought（思考）：分析、假设、洞见
+   - 📋 Plan（计划）：分解为可执行步骤
+   - 🎯 Action（行动）：具体、可执行、可验证的下一步
+
+**2. 执行导向**
+   - 强制要求 action 字段
+   - 每个步骤都有明确的下一步
+   - 支持工具调用建议
+
+**3. 会话隔离**
+   - 支持 sessionId 区分不同会话
+   - 多任务并行管理
+   - 独立记录和追踪
+
+**4. 结构化强**
+   - 固定结构，使用简单
+   - 便于复盘和优化
+   - 适合团队协作
+
+## 📋 使用指南
+
+**参数说明：**
+- thought（必需）：当前思考内容，分析、假设、洞见、反思
+- plan（必需）：针对当前任务的计划或方案，分解为可执行步骤
+- action（必需）：下一步行动，必须具体、可执行、可验证，可以是工具调用
+- thoughtNumber（必需）：思考步骤编号，用于追踪和回溯
+- sessionId（可选）：会话标识符，默认为 'default'
+
+**使用流程：**
+1. 明确任务目标
+2. 思考当前步骤的核心问题
+3. 制定具体的执行计划
+4. 定义明确的下一步行动（可包含工具调用）
+5. 按编号顺序记录每个步骤
+6. 完成后可获取摘要和回顾
+
+## 💡 典型使用示例
+
+**示例1：功能开发**
+- Thought: "需要实现用户登录功能，考虑安全性和用户体验"
+- Plan: "1. 设计登录接口 2. 实现密码加密 3. 添加验证码 4. 编写测试"
+- Action: "调用代码生成工具创建登录接口框架"
+
+**示例2：部署任务**
+- Thought: "需要将新版本安全部署到生产环境"
+- Plan: "1. 备份当前版本 2. 执行数据库迁移 3. 部署新代码 4. 验证功能"
+- Action: "执行备份脚本，检查备份是否成功"
+
+**示例3：报告编写**
+- Thought: "需要完成月度业务分析报告"
+- Plan: "1. 收集数据 2. 分析趋势 3. 编写报告 4. 审核发布"
+- Action: "调用数据分析工具提取本月业务数据"
+
+## 🔄 与 sequentialthinking 的配合使用
+
+**推荐工作流：**
+1. **探索阶段** → 使用 sequentialthinking
+   - 分析问题、探索方案、验证假设
+2. **执行阶段** → 使用 think_and_plan
+   - 将确定的方案转化为可执行步骤
+   - 追踪执行进度和结果`,
+            inputSchema: {
+                thought: z.string().describe('当前的思考内容，可以是对问题的分析、假设、洞见、反思或对前一步骤的总结。强调深度思考和逻辑推演，是每一步的核心。'),
+                plan: z.string().describe('针对当前任务拟定的计划或方案，将复杂问题分解为多个可执行步骤。'),
+                action: z.string().describe('基于当前思考和计划，建议下一步采取的行动步骤，要求具体、可执行、可验证，可以是下一步需要调用的一个或多个工具。'),
+                thoughtNumber: z.string().describe('当前思考步骤的编号，用于追踪和回溯整个思考与规划过程，便于后续复盘与优化。'),
+                sessionId: z.string().optional().describe('会话标识符，用于区分不同会话的记录，默认为 \'default\'')
+            },
+            handler: async (args) => {
+                return handleThinkPlan(args);
             }
         }
         // {