bonito-mcp
The killer differentiator of Bonito (BON-004): an MCP server that gives any AI agent (Claude, Bedrock, Strands) native access to deep database observability. No Datadog DB Monitoring, DBmarlin or Percona PMM expose MCP — Bonito does.
It is a thin wrapper over the bonito-api REST layer (business logic lives in
store/API, not duplicated here).
Run
uv pip install -e bonito-mcp
export BONITO_API_URL=http://localhost:8100
export BONITO_API_KEY=change-me
bonito-mcp # stdio transport
Connect to an agent
Claude Desktop — claude_desktop_config.json:
{
"mcpServers": {
"bonito": {
"command": "bonito-mcp",
"env": { "BONITO_API_URL": "http://localhost:8100", "BONITO_API_KEY": "change-me" }
}
}
}
Claude CLI:
claude mcp add bonito -- bonito-mcp
Bedrock / Strands: the same server runs over stdio/SSE — wire it as a tool provider and the agent gets all 8 tools.
Tools
| Tool | What the agent asks |
|---|---|
get_slow_queries |
"which queries are slow?" |
get_active_locks |
"are there locks right now?" |
get_blocking_tree |
"who is blocking whom?" |
explain_query |
"what's the execution plan for this query?" |
get_wait_analysis |
"what are the sessions waiting on?" |
compare_to_baseline |
"is this query slower than usual?" |
suggest_remediation |
"what should I do about a lock / slow query / bloat?" |
get_db_health_summary |
"give me a health summary of the database" |
Config
| Env var | Default | Description |
|---|---|---|
BONITO_API_URL |
http://localhost:8100 |
Base URL of bonito-api |
BONITO_API_KEY |
(required) | API key matching the API's BONITO_API_KEY |
Token governance
query_text is truncated to 500 chars before returning to the LLM; no
secrets are ever included in tool output.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file bonito_mcp_server-0.1.2.tar.gz.
File metadata
- Download URL: bonito_mcp_server-0.1.2.tar.gz
- Upload date:
- Size: 7.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.8.17
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b5c608b713dd2994598b460355fc667f50572ebc7aad8f9e81965e397b2dec8a
|
|
| MD5 |
c607e9a2b80063cade36cee72bcd970a
|
|
| BLAKE2b-256 |
8aff26b9f458a51c3550d46708761630417d0888a7b497c1d99d9ebd49f845ec
|
File details
Details for the file bonito_mcp_server-0.1.2-py3-none-any.whl.
File metadata
- Download URL: bonito_mcp_server-0.1.2-py3-none-any.whl
- Upload date:
- Size: 7.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.8.17
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a20ecea05fb934d59dc94ec079df51f1c9fefee1a5829ae0d7a1220cfb625833
|
|
| MD5 |
d97c7bb718e42f71e9ebcdd701cc7033
|
|
| BLAKE2b-256 |
9651f1c97b446b480f8fe031dbf65ca214992622bfcd0671bd41451b643e3254
|