工具接口

获取所有工具

GET /api/tools/list

查询参数

参数	类型	说明
category	string	按类别过滤
source	string	按来源过滤 (builtin/custom/mcp)

响应

{
  "success": true,
  "data": [
    {
      "name": "get_current_time",
      "description": "获取当前时间",
      "category": "basic",
      "source": "builtin",
      "parameters": {
        "type": "object",
        "properties": {
          "timezone": {
            "type": "string",
            "description": "时区"
          }
        }
      }
    }
  ]
}

获取内置工具列表

GET /api/tools/builtin/list

响应

{
  "success": true,
  "data": [
    {
      "name": "get_current_time",
      "description": "获取当前时间",
      "category": "basic",
      "source": "builtin",
      "inputSchema": {...}
    }
  ]
}

测试工具执行

POST /api/tools/test

请求体

{
  "toolName": "get_current_time",
  "arguments": {
    "timezone": "Asia/Shanghai"
  }
}

响应

{
  "success": true,
  "toolName": "get_current_time",
  "result": "2024-12-15 14:30:25",
  "duration": 15
}

获取内置工具配置

GET /api/tools/builtin/config

响应

{
  "success": true,
  "data": {
    "enabledCategories": ["basic", "user", "web"],
    "disabledTools": []
  }
}

更新内置工具配置

PUT /api/tools/builtin/config

请求体

{
  "enabledCategories": ["basic", "user"],
  "disabledTools": ["execute_command"]
}

获取自定义工具列表

GET /api/tools/custom

响应

{
  "success": true,
  "data": [
    {
      "name": "my_tool",
      "file": "my-tool.js",
      "enabled": true
    }
  ]
}

上传自定义工具

POST /api/tools/custom
Content-Type: multipart/form-data

表单字段

字段	类型	说明
file	File	JS 工具文件

删除自定义工具

DELETE /api/tools/custom/:name

重载工具

POST /api/tools/reload-all

响应

{
  "success": true,
  "data": {
    "builtin": 25,
    "custom": 3,
    "mcp": 10
  }
}

获取工具日志

GET /api/tools/logs

查询参数

参数	类型	说明
limit	number	返回条数 (默认 100)
toolName	string	按工具名过滤
userId	string	按用户过滤

响应

{
  "success": true,
  "data": [
    {
      "id": "uuid",
      "toolName": "get_current_time",
      "args": {},
      "result": "...",
      "userId": "123",
      "duration": 15,
      "timestamp": "2024-12-15T06:30:25.000Z"
    }
  ]
}

获取危险工具配置

GET /api/tools/dangerous

响应

{
  "success": true,
  "data": {
    "allowDangerous": false,
    "dangerousTools": ["execute_command", "delete_file"],
    "adminOnlyTools": ["kick_member"]
  }
}

更新危险工具配置

PUT /api/tools/dangerous

请求体

{
  "allowDangerous": false,
  "dangerousTools": ["execute_command"]
}