mcp-parseable

The mcp-parseable-server provides an MCP interface for interacting with Parseable data streams (logs, metrics, traces) via natural language and structured tool calls. It exposes tools that let you list available data streams, query streams with SQL, retrieve schemas, stats, and information about streams, and obtain Parseable metadata such as about info and user roles. The server supports both HTTP mode for standard agent/tool interactions and stdio mode for CLI or agent-to-agent workflows. You can discover tools through the MCP protocol and then invoke the ones you need (e.g., get_data_streams to enumerate streams, query_data_stream to run SQL queries, or get_data_stream_schema to inspect a stream’s fields). The tooling is designed to be stateless, with responses returned in JSON that blend textual results and structured payloads.

Prerequisites:

• Go 1.20+ installed on your machine
• Git available to clone the repository

Installation steps:

1. Clone the repository git clone https://github.com/thenodon/mcp-parseable-server
2. Build the MCP server binary cd mcp-parseable-server go build -o mcp-parseable-server ./cmd/mcp_parseable_server
3. Run the server (HTTP mode by default on port 9034) ./mcp-parseable-server --listen :9034

Optional modes:

• Run in stdio mode for CLI/agent-to-agent workflows: ./mcp-parseable-server --mode stdio

Configuration:

• You can configure the Parseable connection via environment variables or flags as described in the README (PARSEABLE_URL, PARSEABLE_USERNAME, PARSEABLE_PASSWORD, LISTEN_ADDR, INSECURE, LOG_LEVEL).

Tips and common considerations:

• Authentication is not implemented by default; place a reverse proxy in front of the MCP server if you need authentication or TLS termination.
• In production, consider using a reverse proxy (like nginx or Envoy) to manage TLS, auth, and load balancing.
• Ensure the Parseable instance is reachable from the MCP server (check PARSEABLE_URL, and credentials).
• If the MCP server cannot start due to port or environment issues, verify that port 9034 is available and that Go 1.20+ is installed.
• For debugging, set LOG_LEVEL to debug to obtain verbose logs.
• The MCP Tools Reference lists available tools (e.g., query_data_stream, get_data_streams, get_data_stream_schema, get_data_stream_stats, get_data_stream_info, get_about, get_roles, get_users). Use the MCP discovery mechanisms to learn schemas and inputs/outputs for each tool.