工具接口

获取所有工具

GET /api/tools

查询参数

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

响应

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

按来源分组

GET /api/tools/by-source

响应

{
  "success": true,
  "data": {
    "builtin": [...],
    "custom": [...],
    "mcp": [...]
  }
}

获取工具详情

GET /api/tools/:name

响应

{
  "success": true,
  "data": {
    "name": "get_time",
    "description": "获取当前时间",
    "category": "basic",
    "source": "builtin",
    "parameters": {...},
    "dangerous": false,
    "adminOnly": false
  }
}

执行工具

POST /api/tools/:name/execute

请求体

{
  "args": {
    "timezone": "Asia/Shanghai"
  }
}

响应

{
  "success": true,
  "data": {
    "result": "2024-12-15 14:30:25"
  }
}

获取内置工具配置

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

响应

{
  "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_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"]
}