ToolBox MCP Server

Implementation Reference

• src/tools/buildReload_tool.ts:19-82 (handler)

  Main handler function implementing the tool: runs 'npm run build' in project root, reloads tools, handles success/error responses.
  export default async function (request: any) { try { // 执行编译命令 const buildOutput = execSync('npm run build', { cwd: PROJECT_ROOT, // 使用计算出的项目根目录 encoding: 'utf-8', stdio: 'pipe', timeout: 300000 // 5分钟超时 }); // 阶段 2: 重新加载工具 const handlers = await loadTools(true); return { content: [ { type: "text", text: JSON.stringify({ build: { success: true, output: buildOutput, directory: PROJECT_ROOT // 返回实际使用的目录 }, reload: { success: !!handlers, tools: Object.keys(handlers).length } }, null, 2) } ] }; } catch (error) { const errorInfo = { message: error instanceof Error ? error.message : String(error), stack: error instanceof Error ? error.stack : undefined, directory: PROJECT_ROOT, // 包含目录信息 system: { platform: process.platform, versions: process.versions } }; // 如果是执行命令错误，添加额外信息 if (error instanceof Error && 'code' in error) { Object.assign(errorInfo, { exitCode: error.code, stdout: (error as any).stdout, stderr: (error as any).stderr }); } return { content: [{ type: "text", text: JSON.stringify({ error: "BuildReload_FAILED", details: errorInfo }, null, 2) }], isError: true }; } }
• src/tools/buildReload_tool.ts:11-17 (schema)

  Input schema for the tool: no parameters required.
  export const schema = { name: "buildReload_tool", description: "Execute 'npm run build' and reload tools", type: "object", properties: {}, required: [] };
• src/handler/ToolHandler.ts:109-133 (registration)

  Dynamic loading and registration of all tools (including buildReload_tool) from src/tools directory by importing schema, handler (default), and destroy functions.
  for (const file of toolFiles) { const toolPath = path.join(toolsDir, file); try { // 如果是重新加载，清除模块缓存 if (reload) clearModuleCache(toolPath); // 导入模块，重新加载时添加时间戳防止缓存 const importPath = 'file://' + toolPath + (reload ? `?update=${Date.now()}` : ''); const { default: tool, schema, destroy } = await import(importPath); const toolName = path.parse(toolPath).name; // 注册工具 tools.push({ name: toolName, description: tool.description, inputSchema: schema, destroy: destroy }); // 注册处理函数 handlers[toolName] = async (request: ToolRequest) => { return await tool(request); }; } catch (error) { console.error(`Failed to ${reload ? 'reload' : 'load'} tool ${file}:`, error); } }
• src/tools/buildReload_tool.ts:85-88 (helper)

  Tool cleanup function called during unload/reload.
  export async function destroy() { // Release resources, stop timers, disconnect, etc. console.log("Destroy buildReload_tool"); }