yuanzhipeng
635313a7ab
feat(lzwcai-agile-db): 更新版本至0.4.4并优化数据库管理技能文档 - 更新版本号从0.4.2到0.4.4 - 优化API密钥权限管理说明，明确grant_api_key_permissions仅支持追加不支持撤销 - 新增add_sql_tool_to_datasource工具，提供一键创建SQL工具功能 - 调整create_sql_tool说明，强调需技能已存在 - 强化数据写操作安全机制，插入/更新/删除前必须预览并等待用户确认 - 完善导入数据功能说明，详细解释confirm_import_data参数传递方式 - 补充技能与工具管理流程，提供更清晰的操作指引 - 新增数字员工平台数据库技能配置指南文档 ```
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：连接实例 CRUDtest_connection/change_connection_status：连接测试与状态切换realtime_structure/realtime_databases/realtime_tables：实时查询库表结构create_builtin_postgresql/update_builtin_database：内置 PostgreSQL 连接管理execute_sql：执行原生 SQLcreate_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：
uv sync
uv run python -m lzwcai_mcp_agile_db_third.main
或使用 pip：
python -m venv .venv
.venv\Scripts\python -m pip install mcp httpx
.venv\Scripts\python -m lzwcai_mcp_agile_db_third.main
安装为命令后：
lzwcai-mcp-agile-db-third
使用 mcp CLI
mcp dev lzwcai_mcp_agile_db_third/main.py
注意事项
- 所有写操作（创建/修改/删除）会先落到
prod环境；带target参数的工具可切换为test import_document_preview通过本地文件路径上传 Excel/CSV- 执行删除类工具前，调用方应遵循安全确认原则，向用户展示影响范围并二次确认
- 日志文件中会对
password、apiKey、token、secret等敏感字段进行脱敏