OpenObserve MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
OpenObserve MCP Server
Read-only MCP server for the OpenObserve Open Source edition. It lets an MCP client discover and investigate logs and metrics, and exposes no tool that modifies data or configuration.
Tools
health_check: verifies connectivity, credentials, and configured organization scope.list_organizations: lists only organizations allowed by local configuration.list_streams: compact stream list with filtering, sorting, pagination, and data-only filtering.get_stream_overview: stream stats and field list.get_stream_schema: full schema, stats, and settings for a selected stream.search_logs: read-only SQL search with time-range, result-size, and SQL-statement guardrails.search_values: frequent distinct field values in a selected time range.search_around: records around a_timestamp, within OpenObserve's five-minute context window.query_metricsandquery_metrics_range: read-only PromQL queries.
Related MCP server: mcp-opensearch
Guardrails
Only organizations listed in
O2_ALLOWED_ORGScan be queried.Requests time out after
O2_REQUEST_TIMEOUT_MS(30 seconds by default).SQL accepts one
SELECTorWITHstatement. Semicolons and write or administrative keywords are rejected.Search results are capped at 100 records. Field-value and around searches have separate caps.
A log-search range over seven days requires
allow_large_range: true.Tool output is capped at 50,000 characters.
Limitations
These are MCP-side safety limits, not a security boundary. The permissions of the OpenObserve user you authenticate with are the real authorization boundary. Use a dedicated read-only account, not a personal or admin account.
The SQL check is a keyword filter. It can reject harmless queries, for example a
LIKE '%update%'filter or a string literal containing;.Authentication uses HTTP Basic Auth. Use an
https://base URL, otherwise the credentials are sent unencrypted.
Setup
Requirements: Node.js 18 or newer.
git clone https://github.com/bilscode/openobserve-mcp.git
cd openobserve-mcp
npm install
npm run buildConfigure through environment variables, either exported in your shell or set in your MCP client:
export O2_BASE_URL="https://openobserve.example.com"
export O2_AUTH_TOKEN="<base64-of-email:password>"
export O2_ALLOWED_ORGS="my-org-dev,my-org-prod"
export O2_REQUEST_TIMEOUT_MS="30000"Variable | Required | Description |
| yes | OpenObserve base URL |
| yes | Base64 of |
| yes | Comma-separated organization identifiers the server may query |
| no | Request timeout in milliseconds, default |
Generate the Basic Auth token locally:
printf '%s' 'email@example.com:password' | base64Never commit the token or a real password. Base64 is encoding, not encryption. Rotate any credential that has been shared in chat, committed, or placed in documentation.
MCP Client Configuration
Example command-based configuration:
{
"mcpServers": {
"openobserve": {
"command": "node",
"args": ["/absolute/path/to/openobserve-mcp/dist/index.js"],
"env": {
"O2_BASE_URL": "https://openobserve.example.com",
"O2_AUTH_TOKEN": "<base64-of-email:password>",
"O2_ALLOWED_ORGS": "my-org-dev,my-org-prod",
"O2_REQUEST_TIMEOUT_MS": "30000"
}
}
}
}Example prompts
Run health_check.
List streams with data in my-org-dev, sorted by storage.
Show the overview for my_app_logs in my-org-dev.
Find the twenty most common values of the "service" field in the last hour.
Search the last hour for errors in a selected stream, returning at most 20 rows.
Show logs around timestamp 1793332367611355 in a selected stream.OpenObserve's API uses epoch microseconds for log search timestamps:
const endTime = Date.now() * 1000;
const startTime = (Date.now() - 60 * 60 * 1000) * 1000;Development
npm run build
npm startSee CONTRIBUTING.md for contribution guidelines and SECURITY.md for reporting vulnerabilities.
License
References
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read-only MCP access to sessions, funnels, campaigns, errors, live visitors, and anomalies.
Read-only access to a Lumin project's logs, metrics, uptime checks, alerts and infrastructure.
Access New Relic observability data through MCP - query metrics, logs, traces, entities, and more
Read-only MCP access to a documented IT fleet: state, changes, posture. 15 tools.
Related MCP Servers
- AlicenseBqualityDmaintenanceA read-only MCP server for OpenObserve Community Edition that works over the REST API. Provides tools for searching logs, traces, stream schemas, and dashboards - no Enterprise license required.873 PyPI16GPL 3.0
- AlicenseAqualityDmaintenanceRead-only MCP server for exploring and searching OpenSearch clusters, enabling log analysis, index exploration, and query execution.8MIT
- AlicenseNot gradedqualityCmaintenanceAn MCP server that enables AI assistants to query and explore your OpenObserve observability data. Provides read-only access to logs, metrics, and traces for analysis and troubleshooting.5MIT
- AlicenseAqualityBmaintenanceEnables read-only querying of Azure Log Analytics and Azure Resource Graph through MCP, supporting KQL queries, workspace discovery, and resource inventory exploration with Azure RBAC authentication.1170 npm2MIT