Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@humio-mcp Search for errors in last hour in repo 'app-logs'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP server for querying Humio/LogScale dashboards and executing search queries.
Built with FastMCP (Python).
list_dashboards — List all dashboards in a Humio repo/view, with optional name filtering
get_dashboard_queries — Extract all search queries (with time ranges) from a dashboard's widgets
execute_search — Run a search query and get results as JSON (default limit: 200 events)
Multi-cluster support via TOML config
Both relative time (24h, 7d) and ISO 8601 (2024-01-01T00:00:00Z) supported
Related MCP server: openobserve-community-mcp
No clone needed. Add this to your VS Code settings.json or .vscode/mcp.json:
{
"servers": {
"humio-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"--from", "git+https://github.com/weihong-xu-hpe/humio-mcp.git",
"humio-mcp"
],
"env": {
"HUMIO_MCP_CONFIG": "${userHome}/.config/humio-mcp/config.toml"
}
}
}
}Then create the config file at ~/.config/humio-mcp/config.toml:
default_cluster = "us-west-2"
[clusters.us-west-2]
url = "https://your-humio-url.example.com/logs"
token = "your-api-token"That's it — uvx handles install and updates automatically.
Prerequisite: uv must be installed (
brew install uvorcurl -LsSf https://astral.sh/uv/install.sh | sh)
git clone https://github.com/weihong-xu-hpe/humio-mcp.git
cd humio-mcp
uv sync
cp config.example.toml config.toml
# Edit config.toml with your cluster URLs and API tokensVS Code config for local clone:
{
"servers": {
"humio-mcp": {
"type": "stdio",
"command": "uv",
"args": ["run", "--directory", "/path/to/HumioMCP", "humio-mcp"]
}
}
}Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"humio-mcp": {
"command": "uvx",
"args": [
"--from", "git+https://github.com/weihong-xu-hpe/humio-mcp.git",
"humio-mcp"
],
"env": {
"HUMIO_MCP_CONFIG": "/Users/yourname/.config/humio-mcp/config.toml"
}
}
}
}Edit config.toml (or ~/.config/humio-mcp/config.toml):
default_cluster = "us-west-2"
[clusters.us-west-2]
url = "https://mira-us-west-2.cloudops.ccs.arubathena.com/logs"
token = "your-api-token"
[clusters.eu-central-1]
url = "https://mira-eu-central-1.example.com/logs"
token = "another-token"Config search order:
HUMIO_MCP_CONFIG environment variable
./config.toml
~/.config/humio-mcp/config.toml
# MCP Inspector (interactive debugging)
uv run fastmcp dev src/humio_mcp/server.py
# Stdio mode
uv run humio-mcpParam | Type | Required | Description |
repo | str | Yes | Repository/view name |
cluster | str | No | Cluster name (default from config) |
search_filter | str | No | Filter by name substring |
Param | Type | Required | Description |
repo | str | Yes | Repository/view name |
dashboard_name | str | Yes | Dashboard name |
cluster | str | No | Cluster name |
Param | Type | Required | Description |
repo | str | Yes | Repository/view name |
query_string | str | Yes | Humio search query |
start | str | No | Start time (default: |
end | str | No | End time (default: |
cluster | str | No | Cluster name |
This server cannot be deployed
Access New Relic observability data through MCP - query metrics, logs, traces, entities, and more
Query Honeycomb observability data: traces, events, metrics, SLOs, triggers, and boards.
Query metrics, targets, entities, and team data in your Steep workspace via MCP.
n8n MCP — query your own n8n instance (BYO).
