db-view-mcp

Name: db-view-mcp
Author: conte777

@conte777

关于 db-view-mcp

MCP server that gives AI assistants direct access to PostgreSQL and ClickHouse databases. Supports stdio and HTTP transports.

#database #postgresql #clickhouse #sql #query

基本信息

分类

数据库

传输方式

stdio

发布者

conte777

提交者

Alexey

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "database": {
      "command": "npx",
      "args": [
        "-y",
        "@conte777/db-view-mcp",
        "--config",
        "/path/to/config.json"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is db-view-mcp?

db-view-mcp is an MCP server that gives AI assistants direct access to PostgreSQL and ClickHouse databases. It supports stdio and HTTP transports, allowing both local IDE integration and remote network access.

How to use db-view-mcp?

Install with npm install @conte777/db-view-mcp, configure a config.json listing databases and optional transport settings, then run via npm start -- --config config.json. Add the server to your MCP client (e.g., Claude Desktop or Claude Code) using the npx command with the config path.

Key features of db-view-mcp

Supports both PostgreSQL and ClickHouse connections simultaneously
Offers read-only tools (SELECT, schema, EXPLAIN) and write tools (INSERT/UPDATE/DELETE, DDL, transactions)
Provides two transport modes: stdio for local IDE use and HTTP for remote/multi-client access
Includes SQL safety with read-only tools that block accidental writes
Supports optional bearer token authentication for HTTP transport
Allows lazy connections (connect on first use) to avoid unneeded startup overhead

Use cases of db-view-mcp

Let AI coding assistants query a project's database directly from an IDE like Cursor or Claude Code
Enable remote database exploration and management via a web application using HTTP transport
Run schema introspection and performance analysis (EXPLAIN ANALYZE, slow query tracking) through AI chat
Perform batch data inserts, updates, or DDL operations via an AI agent in a controlled session

FAQ from db-view-mcp

What databases does db-view-mcp support?

It supports PostgreSQL and ClickHouse. You can connect to any number of instances of either type simultaneously in one server.

How do I switch between stdio and HTTP transport?

Set "transport.type" to "http" in config.json, or use the CLI flag --transport http. The default is stdio.

Can I prevent accidental writes to the database?

Yes. Read-only tools (query, list_tables, etc.) validate SQL to block write keywords. Write operations require the explicit execute or transaction tool.

Does db-view-mcp support transactions?

Yes, for PostgreSQL. The transaction tool allows begin, commit, and rollback. ClickHouse does not support transactions — using the transaction tool on ClickHouse throws an error.

How does authentication work for HTTP transport?

Optional bearer token authentication can be enabled by setting transport.auth.type to "bearer" with a token value. Requests to /mcp must include an Authorization: Bearer <token> header. The /health endpoint is not protected.