DataNexa

简体中文 | English

面向 AI Agent 的本地只读数据库 MCP 网关

DataNexa 是一个运行在本机的数据库 MCP 服务。它为 AI Agent 提供统一、受控且可审计的数据访问入口，在执行查询前应用只读策略，并对返回行数、执行时间和连接数量进行限制。

项目目前支持 SQLite、MySQL 和 PostgreSQL，桌面端基于 Tauri、React 与 Rust 构建。

功能特性

• 统一管理 SQLite、MySQL 和 PostgreSQL 只读连接
• 提供表结构发现、字段描述、数据采样、只读 SQL 和查询计划等 MCP 工具
• 基于 SQL 语法树校验查询，限制为只读语句
• 支持 Bearer Token 鉴权和手动轮换
• 数据库密码保存到操作系统凭证库，不写入常规配置文件
• 支持最大返回行数、查询超时和连接池上限
• 保留本地审计记录，并可对 SQL 字面量进行脱敏
• 提供连接诊断、工具开关、紧急禁用和连接导入/导出
• 支持简体中文、英文以及浅色/深色主题

界面预览

下载与安装

预编译版本可从 Releases 页面下载。请根据操作系统选择对应的安装包或可执行文件，并优先使用最新稳定版本。

首次运行后，按以下顺序完成配置：

1. 新建数据库连接，并使用数据库侧的只读账号。
2. 测试连接，确认网络、凭证和权限配置正确。
3. 在“MCP 服务”页面启动本地服务。
4. 复制 Agent 接入配置，并添加到支持 MCP 的客户端。

从源码构建

环境要求

• Git
• Node.js 20 或更高版本
• pnpm 9
• Rust stable
• Tauri 2 所需的系统依赖

各平台的系统依赖不同，完整说明见 Tauri Prerequisites：

• Windows：Microsoft C++ Build Tools、WebView2，以及 Rust MSVC 工具链
• macOS：Xcode Command Line Tools
• Ubuntu/Debian：libwebkit2gtk-4.1-dev、libayatana-appindicator3-dev、librsvg2-dev、patchelf、xdg-utils

获取源码

git clone https://github.com/MingoZacwu/DataNexa.git
cd DataNexa
corepack enable
corepack prepare pnpm@9 --activate
pnpm install --frozen-lockfile

本地开发

pnpm run dev:app

该命令会启动 Vite 开发服务，并以 Tauri 桌面窗口运行应用。

编译可执行文件

pnpm run build:portable

编译结果位于 src-tauri/target/release/。Windows 下通常为 datanexa.exe，macOS 和 Linux 下为对应平台的 datanexa 可执行文件。

构建安装包

pnpm run build:installer

安装包及平台相关产物位于：

src-tauri/target/release/bundle/

仅需检查前端类型和构建结果时，可运行：

pnpm run build

DataNexa 只能为当前构建平台生成原生应用。若需要 Windows、macOS 和 Linux 版本，请分别在对应系统上构建。

安全说明

“只读”是降低风险的防护措施，不等同于绝对安全。接入真实数据前，建议同时落实以下措施：

• 为 DataNexa 单独创建最小权限数据库账号，并在数据库侧撤销写入和管理权限
• 对敏感表、敏感字段和生产网络设置额外的访问控制
• 保持 Bearer Token 鉴权开启，不要向不可信应用泄露 Token
• 定期检查审计记录，只启用当前任务必需的 MCP 工具
• 对数据库进行必要备份，不要将 DataNexa 作为唯一安全边界

连接导出文件包含明文数据库密码。导出后请将文件保存在访问受控的位置，完成迁移后及时删除，切勿提交到代码仓库或上传到公共存储。

如发现安全问题，请不要在公开 Issue 中披露数据库信息、访问凭证或可直接利用的细节，可通过仓库维护者提供的私有联系方式报告。

参与贡献

欢迎通过 Issues 提交问题和建议，也欢迎提交 Pull Request。提交代码前，请确保前端构建、Rust 格式检查、测试和 Clippy 检查均能通过：

pnpm run build
cargo fmt --manifest-path src-tauri/Cargo.toml -- --check
cargo test --manifest-path src-tauri/Cargo.toml --locked
cargo clippy --manifest-path src-tauri/Cargo.toml --all-targets --locked -- -D warnings

提交 Issue 或日志时，请先移除连接字符串、数据库名称、账号、Token、SQL 字面量及业务数据。

免责与使用须知

数据无价，谨慎使用。

只读策略不能完全保证所有风险都被拦截，仍需主动约束 Agent，避免要求或允许其执行危险的数据库操作。

DataNexa 是由个人独立开发和维护的开源项目，与 MySQL、PostgreSQL、SQLite、MCP 客户端及其所属组织不存在隶属或官方合作关系。

本项目按“原样”提供，不对适用性、可靠性、安全性或数据完整性作任何明示或暗示的保证。因使用或无法使用本项目而产生的数据丢失、服务中断、安全事件或其他损失，项目作者及贡献者在适用法律允许的最大范围内不承担责任。使用者应自行评估风险，并对数据库权限、备份、网络隔离和合规要求负责。

许可证

本项目基于 MIT License 开源。你可以在许可证允许的范围内使用、复制、修改、合并、发布和分发本项目，但必须保留原始版权声明和许可证文本。

版权信息

Copyright (C) 2026 Zachary Wu

MySQL、PostgreSQL、SQLite 及其他名称和商标归其各自权利人所有。