web-manage-mcp 0.4.0

MCP server for Java backend CRUD operations with Sa-Token authentication

Web管理MCP服务器

Java后台管理系统CRUD操作的MCP工具，支持Sa-Token鉴权。

功能

• 创建资源 (POST)
• 查询资源 (GET /{id})
• 更新资源 (PUT)
• 批量删除 (DELETE /batchDelete?ids=)
• 分页查询 (GET ?currentPage=&pageSize=)
• 自定义请求

安装

uvx install web-manage-mcp

MCP配置

{
  "mcpServers": {
    "web-manage-mcp": {
      "command": "uvx",
      "args": ["web-manage-mcp"]
    }
  }
}

注意: 不再需要在环境变量中配置认证信息，所有认证信息通过 java_add_api 工具动态配置。

工具列表

工具	描述	参数
java_add_api	添加API配置	name, base_url, cookie_name?, cookie_token?
java_create	创建资源 POST	api_name, endpoint, data
java_get	查询资源 GET /{id}	api_name, endpoint, item_id
java_update	更新资源 PUT	api_name, endpoint, data
java_delete	批量删除 DELETE	api_name, endpoint, ids
java_list	分页查询 GET	api_name, endpoint, page?, size?, params?
java_custom	自定义请求	api_name, method, endpoint, data?, params?
java_list_apis	列出已配置API	无
java_update_token	更新token	api_name, token

使用示例

// 1. 配置API（包含认证信息）
java_add_api({
  "name": "admin",
  "base_url": "http://localhost:8080",
  "cookie_name": "satoken",  // 可选，默认为 "satoken"
  "cookie_token": "your-actual-token-value"  // 必填，实际的登录token
})

// 2. 查询用户列表
java_list({
  "api_name": "admin",
  "endpoint": "/admin/user",
  "page": 1,
  "size": 10
})

// 3. 新增用户
java_create({
  "api_name": "admin",
  "endpoint": "/admin/user",
  "data": {"username": "test", "password": "123456"}
})

// 4. 更新用户
java_update({
  "api_name": "admin",
  "endpoint": "/admin/user",
  "data": {"id": 1, "username": "test2"}
})

// 5. 删除用户
java_delete({
  "api_name": "admin",
  "endpoint": "/admin/user",
  "ids": [1, 2, 3]
})

// 6. 更新token（如果token过期）
java_update_token({
  "api_name": "admin",
  "token": "new-token-value"
})

支持的后台接口

适配以下接口模式：

• /admin/user - 用户管理
• /admin/role - 角色管理
• /admin/permission - 权限管理
• /admin/dict - 字典管理
• /admin/notice - 通知管理
• /admin/operLog - 操作日志
• /admin/front-user - 前台用户
• /admin/com-query - 通用查询

License

MIT