| 方法     | 接口名称                                            | 入参描述                                             | 一句话作用                  |
| ------ | ----------------------------------------------- | ------------------------------------------------ | ---------------------- |
| GET    | `/api/mcp-tools`                                | `toolGroupId`、`displayName`、`pageNum`、`pageSize` | 分页查询动态工具列表             |
| GET    | `/api/mcp-tools/{id}`                           | 工具 ID                                            | 查询动态工具详情               |
| POST   | `/api/mcp-tools`                                | `McpToolRequest`                                 | 创建动态工具并注册到 MCP Server  |
| PUT    | `/api/mcp-tools/{id}`                           | 工具 ID、`McpToolRequest`                           | 更新动态工具并重新注册            |
| DELETE | `/api/mcp-tools/{id}`                           | 工具 ID                                            | 删除动态工具并从 MCP Server 移除 |
| POST   | `/api/mcp-tools/{id}/toggle`                    | 工具 ID                                            | 启用或禁用动态工具              |
| POST   | `/api/mcp-tools/{id}/tool-groups/{groupId}`     | 工具 ID、工具组 ID                                     | 将工具绑定到工具组              |
| DELETE | `/api/mcp-tools/{id}/tool-groups/{groupId}`     | 工具 ID、工具组 ID                                     | 解除工具与工具组绑定             |
|        |                                                 |                                                  |                        |
| GET    | `/api/tool-groups`                              | `pageNum`、`pageSize`                             | 分页查询工具组列表              |
| GET    | `/api/tool-groups/{id}`                         | 工具组 ID                                           | 查询工具组详情                |
| GET    | `/api/tool-groups/{id}/tools`                   | 工具组 ID、`displayName`                             | 查询工具组关联的全部工具           |
| POST   | `/api/tool-groups`                              | `McpToolGroupRequest`                            | 创建工具组并生成 API Key       |
| PUT    | `/api/tool-groups/{id}`                         | 工具组 ID、`McpToolGroupRequest`                     | 更新工具组名称或描述             |
| DELETE | `/api/tool-groups/{id}`                         | 工具组 ID                                           | 删除工具组并解除相关关联           |
| POST   | `/api/tool-groups/{id}/toggle`                  | 工具组 ID                                           | 启用或禁用工具组               |
| POST   | `/api/tool-groups/{id}/reset-api-key`           | 工具组 ID                                           | 重置工具组 API Key          |
|        |                                                 |                                                  |                        |
| GET    | `/api/roles`                                    | `pageNum`、`pageSize`                             | 分页查询角色列表               |
| GET    | `/api/roles/{id}`                               | 角色 ID                                            | 查询角色详情                 |
| POST   | `/api/roles`                                    | `RoleRequest`                                    | 创建角色并生成角色 Key          |
| PUT    | `/api/roles/{id}`                               | 角色 ID、`RoleRequest`                              | 更新角色名称或描述              |
| DELETE | `/api/roles/{id}`                               | 角色 ID                                            | 删除角色并解除工具组关联           |
| POST   | `/api/roles/{id}/toggle`                        | 角色 ID                                            | 启用或禁用角色                |
| POST   | `/api/roles/{id}/reset-key`                     | 角色 ID                                            | 重置角色 Key               |
| GET    | `/api/roles/{id}/tool-groups`                   | 角色 ID                                            | 查询角色可用工具组              |
| POST   | `/api/roles/tool-groups`                        | `roleId`、`toolGroupId`                           | 给角色关联工具组               |
| DELETE | `/api/roles/{roleId}/tool-groups/{toolGroupId}` | 角色 ID、工具组 ID                                     | 移除角色的工具组关联             |