badger-db-mcp 0.19.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Bytebase
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,120 @@
+> [!NOTE]  
+> Brought to you by [Bytebase](https://www.bytebase.com/), open-source database DevSecOps platform.
+
+<p align="center">
+<a href="https://dbhub.ai/" target="_blank">
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/bytebase/dbhub/main/docs/images/logo/full-dark.svg" width="75%">
+  <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/bytebase/dbhub/main/docs/images/logo/full-light.svg" width="75%">
+  <img src="https://raw.githubusercontent.com/bytebase/dbhub/main/docs/images/logo/full-light.svg" width="75%" alt="DBHub Logo">
+</picture>
+</a>
+</p>
+
+```bash
+            +------------------+    +--------------+    +------------------+
+            |                  |    |              |    |                  |
+            |                  |    |              |    |                  |
+            |  Claude Desktop  +--->+              +--->+    PostgreSQL    |
+            |                  |    |              |    |                  |
+            |  Claude Code     +--->+              +--->+    SQL Server    |
+            |                  |    |              |    |                  |
+            |  Cursor          +--->+    DBHub     +--->+    SQLite        |
+            |                  |    |              |    |                  |
+            |  VS Code         +--->+              +--->+    MySQL         |
+            |                  |    |              |    |                  |
+            |  Copilot CLI     +--->+              +--->+    MariaDB       |
+            |                  |    |              |    |                  |
+            |                  |    |              |    |                  |
+            +------------------+    +--------------+    +------------------+
+                 MCP Clients           MCP Server             Databases
+```
+
+DBHub is a zero-dependency, token efficient MCP server implementing the Model Context Protocol (MCP) server interface. This lightweight gateway allows MCP-compatible clients to connect to and explore different databases:
+
+- **Local Development First**: Zero dependency, token efficient with just two MCP tools to maximize context window
+- **Multi-Database**: PostgreSQL, MySQL, MariaDB, SQL Server, and SQLite through a single interface
+- **Multi-Connection**: Connect to multiple databases simultaneously with TOML configuration
+- **Guardrails**: Read-only mode, row limiting, and query timeout to prevent runaway operations
+- **Secure Access**: SSH tunneling and SSL/TLS encryption
+
+## Supported Databases
+
+PostgreSQL, MySQL, SQL Server, MariaDB, and SQLite.
+
+## MCP Tools
+
+DBHub implements MCP tools for database operations:
+
+- **[execute_sql](https://dbhub.ai/tools/execute-sql)**: Execute SQL queries with transaction support and safety controls
+- **[search_objects](https://dbhub.ai/tools/search-objects)**: Search and explore database schemas, tables, columns, indexes, and procedures with progressive disclosure
+- **[Custom Tools](https://dbhub.ai/tools/custom-tools)**: Define reusable, parameterized SQL operations in your `dbhub.toml` configuration file
+
+## Workbench
+
+DBHub includes a [built-in web interface](https://dbhub.ai/workbench/overview) for interacting with your database tools. It provides a visual way to execute queries, run custom tools, and view request traces without requiring an MCP client.
+
+![workbench](https://raw.githubusercontent.com/bytebase/dbhub/main/docs/images/workbench/workbench.webp)
+
+## Installation
+
+See the full [Installation Guide](https://dbhub.ai/installation) for detailed instructions.
+
+### Quick Start
+
+**Docker:**
+
+```bash
+docker run --rm --init \
+   --name dbhub \
+   --publish 8080:8080 \
+   bytebase/dbhub \
+   --transport http \
+   --port 8080 \
+   --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"
+```
+
+**NPM:**
+
+```bash
+npx @bytebase/dbhub@latest --transport http --port 8080 --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"
+```
+
+**Demo Mode:**
+
+```bash
+npx @bytebase/dbhub@latest --transport http --port 8080 --demo
+```
+
+See [Command-Line Options](https://dbhub.ai/config/command-line) for all available parameters.
+
+### Multi-Database Setup
+
+Connect to multiple databases simultaneously using TOML configuration files. Perfect for managing production, staging, and development databases from a single DBHub instance.
+
+See [Multi-Database Configuration](https://dbhub.ai/config/toml) for complete setup instructions.
+
+## Development
+
+```bash
+# 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"
+```
+
+See [Testing](.claude/skills/testing/SKILL.md) and [Debug](https://dbhub.ai/config/debug).
+
+## Contributors
+
+<a href="https://github.com/bytebase/dbhub/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=bytebase/dbhub" />
+</a>
+
+## Star History
+
+![Star History Chart](https://api.star-history.com/svg?repos=bytebase/dbhub&type=Date)

package/package.json

@@ -0,0 +1,93 @@
+{
+  "name": "badger-db-mcp",
+  "version": "0.19.0",
+  "mcpName": "badger-db-mcp",
+  "description": "Badger DB MCP — minimal, token-efficient Database MCP Server for PostgreSQL, MySQL, SQL Server, SQLite, MariaDB",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ajgreyling/badger-db-mcp.git"
+  },
+  "bugs": "https://github.com/ajgreyling/badger-db-mcp/issues",
+  "homepage": "https://github.com/ajgreyling/badger-db-mcp#readme",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "badger-db-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@aws-sdk/rds-signer": "^3.1001.0",
+    "@azure/identity": "^4.8.0",
+    "@iarna/toml": "^2.2.5",
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "better-sqlite3": "^11.9.0",
+    "dotenv": "^16.4.7",
+    "express": "^4.18.2",
+    "mariadb": "^3.4.0",
+    "mssql": "^11.0.1",
+    "mysql2": "^3.13.0",
+    "pg": "^8.13.3",
+    "ssh-config": "^5.0.3",
+    "ssh2": "^1.16.0",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@testcontainers/mariadb": "^11.0.3",
+    "@testcontainers/mssqlserver": "^11.0.3",
+    "@testcontainers/mysql": "^11.0.3",
+    "@testcontainers/postgresql": "^11.0.3",
+    "@types/better-sqlite3": "^7.6.12",
+    "@types/express": "^4.17.21",
+    "@types/mssql": "^9.1.7",
+    "@types/node": "^22.13.10",
+    "@types/pg": "^8.11.11",
+    "@types/ssh2": "^1.15.5",
+    "concurrently": "^9.2.1",
+    "cross-env": "^7.0.3",
+    "openapi-typescript": "^7.10.1",
+    "prettier": "^3.5.3",
+    "testcontainers": "^11.0.3",
+    "ts-node": "^10.9.2",
+    "tsup": "^8.4.0",
+    "tsx": "^4.19.3",
+    "typescript": "^5.8.2",
+    "vitest": "^4.0.6"
+  },
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "esModuleInterop": true,
+    "strict": true,
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": [
+    "src/**/*"
+  ],
+  "scripts": {
+    "build": "pnpm run generate:api-types && tsup && cd frontend && pnpm run build",
+    "build:backend": "pnpm run generate:api-types && tsup",
+    "build:frontend": "cd frontend && pnpm run build",
+    "start": "node dist/index.js",
+    "dev": "concurrently --kill-others \"pnpm run dev:backend\" \"pnpm run dev:frontend\"",
+    "dev:backend": "NODE_ENV=development tsx src/index.ts --transport=http",
+    "dev:frontend": "cd frontend && pnpm run dev",
+    "crossdev": "cross-env NODE_ENV=development tsx src/index.ts",
+    "generate:api-types": "openapi-typescript src/api/openapi.yaml -o src/api/openapi.d.ts",
+    "test": "vitest run",
+    "test:unit": "vitest run --project unit",
+    "test:watch": "vitest",
+    "test:integration": "vitest run --project integration"
+  }
+}