OBDiag MCP Server - Model Context Protocol server for OceanBase Diagnostic Tool
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"obdiag-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# OBDiag MCP Server A Model Context Protocol (MCP) server that enables secure interaction with OBDiag (OceanBase Diagnostic Tool). English | [简体中文](../doc/obdiag_mcp_server_CN.md) ## Overview The OBDiag MCP Server provides a standardized interface for AI assistants to interact with OceanBase diagnostic tools through the Model Context Protocol. It allows you to perform cluster diagnostics, log analysis, and system health checks programmatically. ## Features - **Cluster Inspection**: Perform comprehensive cluster health checks and generate inspection reports - **Log Analysis**: Analyze cluster logs to identify error messages and performance issues - **Scene-based Diagnostics**: Execute specific diagnostic scenarios with customizable parameters - **Multiple Transport Protocols**: Support for stdio, SSE, and streamable-http transport modes - **Easy Integration**: Simple setup and configuration for MCP-compatible clients ## Prerequisites Before using the OBDiag MCP Server, ensure that: 1. **Python 3.10+**: The server requires Python 3.10 or higher 2. **OBDiag is installed**: The server requires OBDiag to be installed and accessible via the `obdiag` command 3. **Configuration file exists**: The OBDiag configuration file should be present at `~/.obdiag/config.yml` ## Installation ### From Source 1. Clone the repository: ```bash git clone https://github.com/oceanbase/mcp-oceanbase.git cd mcp-oceanbase ``` 2. Navigate to the obdiag MCP server directory: ```bash cd src/obdiag_mcp_server ``` 3. Install the package: ```bash pip install -e . ``` ### Using pip ```bash pip install obdiag-mcp ``` ## Usage ### Command Line The server can be started with different transport protocols: ```bash # stdio mode (for direct integration) obdiag-mcp stdio # SSE mode (default port 8000) obdiag-mcp sse # SSE mode with custom port obdiag-mcp sse 8001 # streamable-http mode (default port 8000) obdiag-mcp streamable-http # streamable-http mode with custom port obdiag-mcp s…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.