Db MCP C271bf33

MCP数据服务

提供方 apelogic-ai

数据服务 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaude
查看接入方式

db-mcp是一个开源MCP服务器,连接Claude Desktop到您的数据库,提供自学习的语义层,使查询更智能。

一句话选型结论

按资料字段整理

Db MCP C271bf33 属于数据服务类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类数据服务 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 5 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

数据服务
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

数据库连接Python本地部署自然语言查询语义层本地运行开源工具

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
uv run db-mcp --help

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
数据库查询

用自然语言查库、取数,不用手写 SQL。

数据同步与清洗

把多来源数据拉到一处做整理。

报表取数

按口径快速拉出统计结果。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在数据服务场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Db MCP C271bf33当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Memory 9d25f64e 9 未标注 未标注 无 2026-05-17
Getzep MCP 9 stdio · 本地进程 本地部署 有 2026-05-17
anything-llm 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Prisma MCP Server 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Astr Bot 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

数据服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方apelogic-ai上游标注的维护方 apelogic-ai
分类数据服务本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

8.3 KB
来自项目仓库与上游目录的原文,未做删改

db-mcp

Your teams are copy-pasting company data into Claude. Give them a safe way to do it.

db-mcp is an open-source MCP server that connects Claude Desktop to your databases—with a self-improving semantic layer that gets smarter with every query.

> No infrastructure needed. Runs locally. Data never leaves your network.

Installation```bash

curl -fsSL https://download.apelogic.ai/db-mcp/install.sh | sh


## Why db-mcp?

- **Ask Claude, get answers** — Stop waiting for reports. Query your data in natural language without SQL, copy-pasting schemas, or context-setting
- **Self-improving semantic layer** — Auto-generates descriptions of your schema, then learns from every query to improve accuracy over time
- **Runs on your desktop** — No cloud infrastructure, no data leaving your network. Uses your existing database credentials and access controls
- **Git-style collaboration** — Data teams review and approve semantic layer improvements. You stay in control, users get accurate answers
- **Open source & auditable** — MIT licensed, fully transparent, no vendor lock-in

## Who is db-mcp for?

| Role | Benefit |
|------|---------|
| **Business Teams** | Ask Claude questions about your data and get accurate answers instantly—no SQL required |
| **Data Teams** | Turn your warehouse into an agent-ready platform with a semantic layer that builds itself |
| **IT & Security** | Govern AI data access with full interaction history, read-only enforcement, and cost guards |

## How It Works

**From install to insight in four steps:**

1. **Install** — Download db-mcp to your laptop. No infrastructure needed—runs locally in minutes
2. **Connect** — Add data sources using your existing credentials. Your security posture stays intact
3. **Query** — Ask Claude questions across your connected data. Every query is validated before execution
4. **Improve** — The semantic layer learns from usage. Review and approve improvements with a git-style workflow

## Quick Start```bash
# Configure your database and Claude Desktop
db-mcp init

# Check configuration
db-mcp status

Supported Agents

Claude Desktop

The default setup works with Claude Desktop. Follow the Quick Start instructions above.

OpenClaw

db-mcp works with OpenClaw via mcporter:```bash

Install mcporter (MCP bridge for OpenClaw)

npm i -g mcporter

Configure db-mcp for OpenClaw

db-mcp init


Or manually add to `~/.openclaw/workspace/config/mcporter.json`:```json
{
  "mcpServers": {
    "db-mcp": {
      "command": "db-mcp",
      "args": ["start"]
    }
  }
}

Supported Databases

  • PostgreSQL
  • ClickHouse
  • Trino
  • MySQL
  • SQL Server

Security & Governance

  • Runs locally — Data stays on your machine, never routed through external servers
  • Read-only by default — Query validation and cost guards prevent accidental data modification
  • Uses existing RBAC — Connects with your database credentials and respects your access controls
  • Full audit trail — Complete interaction history for compliance and debugging
  • Open source — Fully auditable, MIT licensed

Commands

Setup & Configuration

Command Description
db-mcp init [NAME] Interactive setup wizard - configure database and Claude Desktop
db-mcp status Show current configuration status
db-mcp config Open config file in editor

Connection Management

Command Description
db-mcp list List all configured connections
db-mcp use NAME Switch to a different connection
db-mcp edit [NAME] Edit connection credentials (.env file)
db-mcp rename OLD NEW Rename a connection
db-mcp remove NAME Remove a connection
db-mcp all COMMAND Run a command for all connections

Server & Diagnostics

Command Description
db-mcp start Start the MCP server (stdio mode for Claude Desktop)
db-mcp console Start local trace console (view MCP server activity)
db-mcp traces Manage trace capture for diagnostics and learning

Git Sync (Team Collaboration)

Command Description
db-mcp git-init [NAME] Enable git sync for an existing connection
db-mcp sync [NAME] Sync connection changes with git remote
db-mcp pull [NAME] Pull connection updates from git remote

Migration

Command Description
db-mcp migrate Migrate from legacy storage format to new connection structure

Configuration

Connection data is stored in ~/.db-mcp/:```
~/.db-mcp/
├── config.yaml # Global config, active connection
└── connections/{name}/
├── .env # Database credentials (gitignored)
├── state.yaml # Onboarding state
├── schema/
│ └── descriptions.yaml # Table/column descriptions
├── domain/
│ └── model.md # Domain model documentation
├── training/
│ ├── examples.yaml # Query examples (NL → SQL mappings)
│ └── instructions.yaml # Custom SQL generation rules
└── .git/ # Optional git sync for team sharing


### Configuration Artifacts

| File | Purpose |
|------|---------|
| `config.yaml` | Global settings: active connection, preferences |
| `.env` | Database URL and credentials (never committed to git) |
| `state.yaml` | Onboarding progress (discovery → review → domain-building → complete) |
| `schema/descriptions.yaml` | Human-readable descriptions of tables and columns |
| `domain/model.md` | Business domain documentation for the LLM |
| `training/examples.yaml` | Known-good query examples to guide SQL generation |
| `training/instructions.yaml` | Custom rules and constraints for SQL generation |

### Environment Variables

| Variable | Description |
|----------|-------------|
| `DATABASE_URL` | Connection string (required) |
| `CONNECTION_NAME` | Override active connection |
| `CONNECTION_PATH` | Override connection directory path |
| `LOG_LEVEL` | Logging verbosity (default: INFO) |

## Development```bash
# Clone
git clone https://github.com/apelogic-ai/db-mcp.git
cd db-mcp

# Install dependencies
uv sync

# Run locally
cd packages/core
uv run db-mcp --help

# Lint
cd packages/core && uv run ruff check . --fix
cd packages/ui && bun run lint

# Build binary
cd packages/core
uv run python scripts/build.py

Testing

93 tests across three layers:```bash

Python unit tests (49 tests)

cd packages/core
uv run pytest tests/ -v

UI unit tests (20 tests)

cd packages/ui
bun run test

UI E2E tests (24 tests)

cd packages/ui
bunx playwright test


All tests run in CI via GitHub Actions on every push and PR. See docs/testing.md for the full testing guide.

#### Tool Coverage Check

Verify that 100% of MCP tools implemented in the codebase are exposed by the MCP server at runtime:```bash
# Run the tool coverage audit (default SQL mode)
python scripts/tool_coverage_audit.py

# Test different configuration modes
python scripts/tool_coverage_audit.py --config api
python scripts/tool_coverage_audit.py --config shell
python scripts/tool_coverage_audit.py --config metabase

# Verbose output with all tool names
python scripts/tool_coverage_audit.py --verbose

# JSON output for CI integration
python scripts/tool_coverage_audit.py --json

The audit returns exit code 0 on success (100% coverage) and 1 on failure.

Project Structure```

db-mcp/
├── packages/
│ ├── core/ # Main application (db-mcp)
│ ├── models/ # Shared Pydantic models (db-mcp-models)
│ └── ui/ # Next.js control plane UI
├── docs/ # Design documents
├── scripts/ # Installation scripts
└── .github/workflows/ # CI/CD
```

Roadmap

See docs/ for design documents on planned features:
- Metrics Layer - Semantic metric definitions (DAU, revenue, etc.)
- Desktop App - Electron GUI with visual query builder
- Knowledge Extraction - Learn from query traces automatically
- Data Gateway - Unified access to multiple data sources

Resources

  • GitHub
  • Discord Community
  • Report Issues

License

MIT

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Db MCP C271bf33 怎么安装?

在客户端按下面的安装命令接入:uv run db-mcp --help。装完在客户端配置里引用同一个包或端点。

Db MCP C271bf33 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Db MCP C271bf33 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Db MCP C271bf33 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Db MCP C271bf33 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Db MCP C271bf33 能提供哪些能力?

资料显示能力标签包括 数据库连接、本地运行、Python、Claude、开源工具。具体工具清单以官方文档为准。

Db MCP C271bf33 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Db MCP C271bf33 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。