Badger Db MCP

\[！注意\]\ 给你带来的 Bytebase开源数据库DevSecOps平台。

Badger DB MCP

flowchart LR
    subgraph clients["MCP Clients"]
        c1[Claude Desktop]
        c2[Claude Code]
        c3[Cursor]
        c4[VS Code]
        c5[Copilot CLI]
    end

    S[Badger DB MCP]

    subgraph databases["Databases"]
        d1[PostgreSQL]
        d2[SQL Server]
        d3[SQLite]
        d4[MySQL]
        d5[MariaDB]
    end

    clients --> S
    S --> databases

Badger DB MCP是一个实现模型上下文协议（MCP）服务器接口的零依赖、令牌高效的MCP服务器。这个轻量级网关允许MCP兼容的客户端连接到并探索不同的数据库。这是一把叉子 DBHub.

• 地方发展优先：零依赖，令牌高效，只需两个MCP工具即可最大化上下文窗口
• 多数据库：PostgreSQL、MySQL、MariaDB、SQL Server和SQLite通过单个接口
• 多连接：使用TOML配置同时连接到多个数据库
• 护栏：默认情况下为只读（单DSN模式）；使用 --allow-destructive-sql=true 允许写入。行限制和查询超时，以防止操作失控
• 安全访问：SSH隧道和SSL/TLS加密

支持的数据库

PostgreSQL、MySQL、SQL Server、MariaDB和SQLite。

MCP工具

Badger DB MCP实现了用于数据库操作的MCP工具：

• execute_sql：使用事务支持和安全控制执行SQL查询
• 搜索对象：通过渐进式披露搜索和探索数据库模式、表、列、索引和过程
• 自定义工具：在您的数据库中定义可重用的参数化SQL操作 dbhub.toml 配置文件

工作台

Badger DB MCP包括 内置web界面 用于与数据库工具交互。它提供了一种可视化的方式来执行查询、运行自定义工具和查看请求跟踪，而不需要MCP客户端。

安装

查看完整 安装指南 详细说明。

快速开始

Docker：

docker run --rm --init \
   --name badger-db-mcp \
   --publish 8080:8080 \
   bytebase/dbhub \
   --transport http \
   --port 8080 \
   --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"

NPM：

npx @bytebase/dbhub@latest --transport http --port 8080 --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"

演示模式：

npx @bytebase/dbhub@latest --transport http --port 8080 --demo

当使用单个DSN（无TOML配置）时，服务器在 只读模式 默认情况下；只允许使用SELECT和其他只读SQL。通过 --allow-destructive-sql=true 以允许插入/更新/删除/合并和类似操作。

看 命令行选项 对于所有可用参数。

多数据库设置

使用TOML配置文件同时连接到多个数据库。非常适合从单个Badger DB MCP实例管理生产、暂存和开发数据库。

看 多数据库配置 有关完整的设置说明。

发展

# Install dependencies
pnpm install

# Run in development mode
pnpm dev

# Build and run for production
pnpm build && pnpm start --transport stdio --dsn "postgres://user:password@localhost:5432/dbname"

贡献者

星史