feat(lzwcai-agile-db): 更新AgileDB技能至v0.4.2版本并扩展工具集
- 将技能版本从0.2.0升级至0.4.2 - 工具数量从33个扩展至57个,新增数据源管理、AI训练、库表关联配置等功能 - 新增MQTT字段关联同步模块(8个工具)和库表关联配置(3个工具) - 添加重要的契约提示和安全确认原则,包括target默认值、alter_table操作限制等 - 修正工具参数说明,如execute_sql的executableSql改为sql,参数结构优化 - 增强安全机制,明确危险操作的用户确认流程和目标资源选择规则 - 更新README.md中的工具数量统计和功能描述
This commit is contained in:
75
lzwcai_mcp_agile_db_third/README.md
Normal file
75
lzwcai_mcp_agile_db_third/README.md
Normal file
@@ -0,0 +1,75 @@
|
||||
# lzwcai-mcp-agile-db-third
|
||||
|
||||
AgileDB 数据源管理 MCP Server,基于 `API_DOCUMENTATION.md` 将后端数据源/连接/DDL/DML/API 接口封装为 34 个 MCP 工具。
|
||||
|
||||
## 功能概述
|
||||
|
||||
本服务将后端 `datasource` 模块的 API 接口代理为标准 MCP 工具,分为两大类:
|
||||
|
||||
### 1. 数据源配置管理
|
||||
|
||||
- `list_datasource_configs`:查询数据源配置列表
|
||||
- `get_datasource_config`:获取数据源配置详情
|
||||
- `batch_create_datasource_configs`:批量创建数据源配置
|
||||
- `replace_datasource_configs`:全量替换数据源配置
|
||||
- `batch_update_datasource_configs`:批量修改数据源配置
|
||||
- `delete_datasource_configs`:批量删除数据源配置
|
||||
- `test_connection_config`:测试数据库连接
|
||||
- `change_datasource_status`:修改数据源状态
|
||||
- `export_datasource_configs`:导出数据源配置为 Excel
|
||||
|
||||
### 2. 数据库连接实例管理
|
||||
|
||||
- `list_connections` / `get_connection` / `create_connection` / `update_connection` / `delete_connection`:连接实例 CRUD
|
||||
- `test_connection` / `change_connection_status`:连接测试与状态切换
|
||||
- `realtime_structure` / `realtime_databases` / `realtime_tables`:实时查询库表结构
|
||||
- `create_builtin_postgresql` / `update_builtin_database`:内置 PostgreSQL 连接管理
|
||||
- `execute_sql`:执行原生 SQL
|
||||
- `create_database` / `create_table` / `create_database_table` / `alter_database` / `alter_table`:DDL 操作
|
||||
- `generate_table`:AI 生成表结构
|
||||
- `import_document_preview` / `import_document_confirm`:Excel/CSV 文档导入
|
||||
- `builtin_table_data` / `builtin_table_insert` / `builtin_table_update` / `builtin_table_delete`:表数据 CRUD
|
||||
|
||||
## 环境配置
|
||||
|
||||
| 环境变量 | 说明 | 默认值 |
|
||||
|----------|------|--------|
|
||||
| `backendBaseUrl` | 后端 API 基础地址 | `http://lzwcai-demp-corp-manager:8086` |
|
||||
| `datasourceApiKey` | 默认 `X-Datasource-API-Key`,可选 | 空 |
|
||||
| `LOG_LEVEL` | 日志级别 | `INFO` |
|
||||
|
||||
## 安装与运行
|
||||
|
||||
使用 uv:
|
||||
|
||||
```bash
|
||||
uv sync
|
||||
uv run python -m lzwcai_mcp_agile_db_third.main
|
||||
```
|
||||
|
||||
或使用 pip:
|
||||
|
||||
```bash
|
||||
python -m venv .venv
|
||||
.venv\Scripts\python -m pip install mcp httpx
|
||||
.venv\Scripts\python -m lzwcai_mcp_agile_db_third.main
|
||||
```
|
||||
|
||||
安装为命令后:
|
||||
|
||||
```bash
|
||||
lzwcai-mcp-agile-db-third
|
||||
```
|
||||
|
||||
## 使用 mcp CLI
|
||||
|
||||
```bash
|
||||
mcp dev lzwcai_mcp_agile_db_third/main.py
|
||||
```
|
||||
|
||||
## 注意事项
|
||||
|
||||
- 所有写操作(创建/修改/删除)会先落到 `prod` 环境;带 `target` 参数的工具可切换为 `test`
|
||||
- `import_document_preview` 通过本地文件路径上传 Excel/CSV
|
||||
- 执行删除类工具前,调用方应遵循安全确认原则,向用户展示影响范围并二次确认
|
||||
- 日志文件中会对 `password`、`apiKey`、`token`、`secret` 等敏感字段进行脱敏
|
||||
Reference in New Issue
Block a user