Seq MCP Server

A Model Context Protocol (MCP) server that provides tools for searching and streaming events from Seq.

Installation

As a .NET Global Tool (Recommended)

# Install
dotnet tool install -g SeqMcpServer

# Update to latest version
dotnet tool update -g SeqMcpServer

# Uninstall
dotnet tool uninstall -g SeqMcpServer

Requirements

• .NET 10.0 Runtime or SDK
• Seq server (local or remote)
• Valid Seq API key

Quick Start

Development Environment

# Clone the repository
git clone https://github.com/willibrandon/seq-mcp-server
cd seq-mcp-server

# Setup development environment (fully automated)
# PowerShell (Windows)
./scripts/setup-dev.ps1

# Bash (Linux/Mac)
./scripts/setup-dev.sh

# Build and run the MCP server
dotnet build
dotnet run --project SeqMcpServer

The setup script automatically:

• Starts a Seq container on ports 15341/18081
• Configures authentication and creates an API key
• Sets up environment variables
• Creates a .env file for the application

Production Deployment

MCP servers are not run directly - they are launched by MCP clients. For production:

1. Build and deploy the executable:

dotnet publish -c Release -r win-x64 -p:PublishSingleFile=true

2. Configure your MCP client to use the deployed executable:

{
  "mcpServers": {
    "seq": {
      "command": "/path/to/seq-mcp-server",
      "env": {
        "SEQ_SERVER_URL": "http://your-seq-server:5341",
        "SEQ_API_KEY": "your-production-api-key"
      }
    }
  }
}

MCP Tools

The following tools are available through the MCP protocol:

• SeqSearch - Search Seq events with filters, date ranges, signals, and pagination

  • Parameters:
    • filter (required): Seq filter expression (use empty string "" for all events)
    • count: Number of events to return (default: 100, max: 1000)
    • signalId (optional): Signal ID to filter events (use SignalList to find IDs)
    • fromDateUtc (optional): Earliest date/time (ISO 8601, e.g., "2024-01-01T00:00:00Z")
    • toDateUtc (optional): Latest date/time (ISO 8601, e.g., "2024-01-31T23:59:59Z")
    • afterId (optional): Event ID to search after (exclusive) - use for pagination
    • timeoutSeconds (optional): Timeout in seconds (1-300)
    • workspace (optional): Specific workspace to query
  • Returns: List of matching events (ordered least to most recent)
  • Note: For date filtering, use fromDateUtc/toDateUtc parameters instead of @Timestamp in the filter expression for better performance
  • Pagination: To fetch more than 1000 events, use afterId with the ID of the last event from the previous search
  • Example filters:
    • "" - all events
    • "error" - events containing "error"
    • @Level = "Error" - error level events
    • Application = "MyApp" - events from specific application
  • Example with date range:
    • filter: "@Level = 'Error'", fromDateUtc: "2024-01-01T00:00:00Z", toDateUtc: "2024-01-31T23:59:59Z"
  • Example with pagination:
    • First call: filter: "", count: 1000 → returns events with IDs
    • Second call: filter: "", count: 1000, afterId: "event-<last-id>" → returns next batch

• SeqWaitForEvents - Wait for and capture live events from Seq (5-second timeout)

  • Parameters:
    • filter (optional): Seq filter expression
    • count: Number of events to capture (default: 10, max: 100)
    • workspace (optional): Specific workspace to query
  • Returns: Snapshot of events captured during the wait period (may be empty if no events match)

• SignalList - List available signals (read-only)

  • Parameters:
    • workspace (optional): Specific workspace to query
  • Returns: List of signals with their definitions

• SeqConvertFilter - Convert fuzzy filter to strict filter expression

  • Parameters:

... View full README on GitHub