Skip to content
MCP server

mcpbus

Local Windows MCP gateway that gives AI assistants scoped access to SQL Server

Runs locally
Install

mcpbus is an MCP server for databases. It runs locally on your machine and is started by your AI client.

Platforms
Windows, CLI
Runs
Locally
Version
1.3.3
Listing updated

Similar MCP servers

Install

Run in a terminal

claude mcp add mcpbus -- npx -y https://github.com/offeconsulting/mcpbus-releases/releases/download/v1.3.3/mcpbus.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcpbus": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/offeconsulting/mcpbus-releases/releases/download/v1.3.3/mcpbus.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcpbus": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/offeconsulting/mcpbus-releases/releases/download/v1.3.3/mcpbus.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcpbus": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/offeconsulting/mcpbus-releases/releases/download/v1.3.3/mcpbus.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcpbus": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/offeconsulting/mcpbus-releases/releases/download/v1.3.3/mcpbus.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcpbus": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/offeconsulting/mcpbus-releases/releases/download/v1.3.3/mcpbus.mcpb"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

About mcpbus

The README describes mcpbus as a local gateway that sits between an AI assistant and your databases, so every query passes through it before reaching SQL Server or PostgreSQL. Access is controlled by the user, who decides which rights are granted, and database passwords are kept inside mcpbus rather than being handed to the assistant.

The product is built around limiting exposure. The website says it defaults to schema-only access and lets you scope permissions per server, per database and per time window, which suits teams that want an assistant to inspect structure without reading every row.

It is aimed at developers and data teams on Windows who want to use MCP-compatible assistants against production-style relational databases without giving them standing credentials or open-ended query rights.

What it does

Schema-only default
Assistants start with structural access to the database and must be granted anything beyond that.
Scoped permissions
Access can be limited per server, per database and per time window.
Credential isolation
Database passwords stay inside mcpbus instead of being exposed to the AI client.
Local stdio install
Runs locally as an MCPB package over stdio on Windows.

Good for

  • Letting an assistant explore a SQL Server schema without seeing table data
  • Granting a time-limited read window to a Postgres database for a specific analysis
  • Connecting MCP clients to internal databases without sharing passwords

mcpbus FAQ

Which databases does mcpbus support?

According to the website and registry entry, it connects to SQL Server and PostgreSQL.

Does mcpbus run locally?

Yes. The registry entry describes it as a local Windows gateway installed from an MCPB package over stdio.

Are database passwords shared with the AI assistant?

The website says passwords stay with mcpbus and every query runs through it.

How do I add mcpbus to Claude Code?

Run this command in your terminal: claude mcp add mcpbus -- npx -y https://github.com/offeconsulting/mcpbus-releases/releases/download/v1.3.3/mcpbus.mcpb

What are the best alternatives to mcpbus?

The closest alternatives to mcpbus are mssqlcl — SQL Server MCP Server & CLI, stoolap, MultiDB MCP, Mysql and Percona Database Service.

Where this comes from

  • Description: written from the project's website and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers