DATABASE TOOL FRAMEWORK / Google
MCP Toolbox for Databases
Serves prebuilt database tools or a configured set of SQL-backed tools and resources to MCP clients.
“MCP Toolbox for Databases is an open source Model Context Protocol (MCP) server that connects your AI agents, IDEs, and applications directly to your enterprise databases.”
01 / THE REASONING
Why this made the selection.
- Allows a deployment to expose task-specific parameterized tools instead of an unrestricted query interface.
- The same project supports ready-made database exploration and custom tools.yaml definitions.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- README.md and LICENSE at aaf88413e117856f80f646da7f1dbc63ebaedea3
- go.mod and main.go at aaf88413e117856f80f646da7f1dbc63ebaedea3
- cmd/root.go, cmd/internal/flags.go and internal/server/mcp.go at aaf88413e117856f80f646da7f1dbc63ebaedea3
- cmd/root.go at aaf88413e117856f80f646da7f1dbc63ebaedea3
Our findings
- The implementation is Go; JavaScript/Python/Java SDKs and the npm launcher are separate interfaces.
- The inspected README documents custom sources, tools and toolsets; permissions follow both those definitions and database grants.
- Without --stdio the server listens on HTTP at 127.0.0.1:5000 by default (cmd/internal/flags.go); internal/server/mcp.go serves POST /mcp, a legacy GET /mcp/sse stream, and per-toolset paths /mcp/{toolsetName}.
- The repository was renamed from genai-toolbox to mcp-toolbox; the Go module was already github.com/googleapis/mcp-toolbox at the previous pin, and the npm launcher is still @toolbox-sdk/server.
- configExample is the README’s prebuilt-tools block at this commit. The README’s HTTP client block has a trailing comma and is not valid JSON, so it was not used.
Not established by this review
- Server startup, authentication and tool execution were not tested.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Connect a server deliberately.
DOCUMENTED COMMAND
npx @toolbox-sdk/server --config tools.yaml Copying does not execute this command. It may retrieve a newer version than the reviewed source.
- The command is the README's Install & Run line: it runs the latest Toolbox server with a tools.yaml you write and review first. It was not run.
- For a prebuilt source instead, configExample is the README's prebuilt PostgreSQL client block (npx with -y, @toolbox-sdk/server, --prebuilt=postgres, --stdio); configure its connection variables using the linked Prebuilt Tools Reference.
Before you start
- Node.js for the npx launcher, and a reviewed tools.yaml; the prebuilt PostgreSQL block needs PostgreSQL connection settings instead.
Documented configuration example
Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.
{
"mcpServers": {
"toolbox-postgres": {
"command": "npx",
"args": [
"-y",
"@toolbox-sdk/server",
"--prebuilt=postgres",
"--stdio"
]
}
}
} 04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
- Official documentation ↗Checked
https://github.com/googleapis/mcp-toolbox/blob/aaf88413e117856f80f646da7f1dbc63ebaedea3/README.md
Supports: summary, upstreamDescription, whySelected, bestFor, limitations, install, access, compatibility, transports, configExample
- Applicable source licence ↗Checked
https://github.com/googleapis/mcp-toolbox/blob/aaf88413e117856f80f646da7f1dbc63ebaedea3/LICENSE
Supports: license
- Implementation: go.mod ↗Checked
https://github.com/googleapis/mcp-toolbox/blob/aaf88413e117856f80f646da7f1dbc63ebaedea3/go.mod
Supports: language, review
- Implementation: main.go ↗Checked
https://github.com/googleapis/mcp-toolbox/blob/aaf88413e117856f80f646da7f1dbc63ebaedea3/main.go
Supports: language, review
https://github.com/googleapis/mcp-toolbox/blob/aaf88413e117856f80f646da7f1dbc63ebaedea3/internal/server/mcp.go
Supports: transports, review
https://github.com/googleapis/mcp-toolbox/blob/aaf88413e117856f80f646da7f1dbc63ebaedea3/cmd/internal/flags.go
Supports: transports, compatibility, review
- MCP Toolbox cmd/root.go ↗Checked
https://github.com/googleapis/mcp-toolbox/blob/aaf88413e117856f80f646da7f1dbc63ebaedea3/cmd/root.go
Supports: limitations, review