Skip to main content
Glama
rubber25ba

DB Query MCP

DB Query MCP 🗄️

让 Claude / AI 助手直接查询 SQLite 数据库。安全只读模式,开箱即用。

功能

Tool(工具)

工具

说明

query(sql, db_path)

执行 SELECT 查询,返回表格化结果

list_tables(db_path)

列出数据库中所有表和视图

describe_table(table, db_path)

查看表结构:字段名、类型、约束、行数

Resource(资源)

资源 URI

说明

db://schema

完整数据库 Schema(所有表 + 列 + 行数)

db://settings

安全配置:只读模式、行数上限、超时等

Related MCP server: querywise-mcp

安全设计

机制

说明

🔒 默认只读

仅允许 SELECT / WITH / EXPLAIN / DESCRIBE / PRAGMA

🚫 危险拦截

DROP / TRUNCATE / ALTER 无条件拦截

📏 行数上限

单次最多 1000 行,防止输出爆炸

⏱️ 超时保护

查询超时 10 秒自动断开

为什么有用?

  • 产品经理对 AI 说「查一下上周注册的用户数」——无需打开数据库客户端

  • 开发对 AI 说「users 表有哪些字段」——即时获取表结构

  • 数据分析师对 AI 说「统计各地区的订单量和金额」——AI 直接写 SQL 查询

快速开始

环境要求

安装

# 克隆仓库
git clone https://github.com/rubber25ba/db-query-mcp.git
cd db-query-mcp

# 安装依赖
pip install fastmcp

运行

python server.py

在 Claude Code 中配置

{
  "mcpServers": {
    "db-query": {
      "command": "python",
      "args": ["C:/Users/YOUR_USER/path/to/db-query-mcp/server.py"]
    }
  }
}

配置后对 Claude 说:

  • 「查一下 /data/app.db 里有哪些表」

  • 「在 /data/app.db 上执行 SELECT * FROM users LIMIT 10」

  • 「帮我看 orders 表的结构」

使用示例

示例 1:探索数据库

用户:/data/business.db 里面有什么表?

Claude → list_tables(db_path="/data/business.db")
→ 返回所有表名和视图名

示例 2:查询数据

用户:统计过去 30 天各品类销售额,用 business.db

Claude → query(
  sql="SELECT category, SUM(amount) as total FROM orders WHERE created_at > date('now', '-30 days') GROUP BY category ORDER BY total DESC",
  db_path="/data/business.db"
)
→ 返回表格化结果

示例 3:查看表结构

用户:users 表有哪些字段?

Claude → describe_table(table_name="users", db_path="/data/business.db")
→ 返回字段名、类型、非空约束、默认值、行数

支持场景

场景

适用

本地 SQLite 数据库查询

产品/运营自助查数据

开发调试(快速看库)

MySQL 数据库

🔜 开发中

技术栈

  • Python + sqlite3(内置)

  • FastMCP — MCP Server 框架

  • MCP — Anthropic 开源协议

定制开发

需要对接 MySQL / PostgreSQL?想把内部数据库集成到 AI 助手?欢迎提 issue 或联系定制:

  • ✉️ GitHub Issue: 提交需求

  • 📋 也承接:企业 API MCP、自动化工作流 MCP、多数据源统一查询 MCP


Built for real business use.

F
license - not found
-
quality - not tested
C
maintenance

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/rubber25ba/db-query-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server