MCP Server Seq

🚀 Seq MCP Server

The Seq API endpoint for interacting with your logging and monitoring system. This server provides full access to all Seq API features via the Model Context Protocol.

✨ Features

Tools

Signal Management

• get-signals - Retrieve signals with filtering options
  • Filter by owner ID
  • Display shared and private signals separately
  • Support partial matching

Event Management

• get-events - Fetch events with rich filtering options
  • Filter by signal ID
  • Customize filtering expressions
  • Configure the maximum number of events (up to 100)
  • Select flexible time ranges
  • Filter by date range

Alert Management

• get-alertstate - Get the current alert state

Resources

Signal List

• signals - List detailed information of all shared signals
  • Signal ID
  • Title
  • Description
  • Sharing status
  • Owner information

📦 Installation

The tool is still under development and has not been pushed to the npm repository. You need to clone this repository locally and then run npm run build

To use it with Claude Desktop, add the server configuration:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "seq": {
      "command":"node",
      "args": ["/Users/ahmadreza/source/ahmad2x4/mcp-server-seq/build/seq-server.js"],
      "env": {
        "SEQ_BASE_URL": "your-seq-url",
        "SEQ_API_KEY": "your-api-key"
      }
    }
  }
}

📚 Configuration

The server requires the following environment variables:

• SEQ_BASE_URL (optional): Your Seq server URL (default is 'http://localhost:8080')
• SEQ_API_KEY (required): Your Seq API key

💻 Usage Examples

Using with Claude Desktop

Add the following content to your claude_desktop_config.json:

{
  "mcpServers": {
    "seq": {
      "command": "npx",
      "args": ["-y", "mcp-seq"],
      "env": {
        "SEQ_BASE_URL": "your-seq-url",
        "SEQ_API_KEY": "your-api-key"
      }
    }
  }
}

🔧 Development

Install Dependencies

npm install

Build the Server

npm run build

Automatic Rebuilding During Development

npm run dev

Run Tests

npm run test-script

⏰ Time Range Options

The get-events tool supports the following time range options:

• 1m - Last 1 minute
• 15m - Last 15 minutes
• 30m - Last 30 minutes
• 1h - Last 1 hour
• 2h - Last 2 hours
• 6h - Last 6 hours
• 12h - Last 12 hours
• 1d - Last 1 day
• 7d - Last 7 days
• 14d - Last 14 days
• 30d - Last 30 days

Debugging

Since the MCP server communicates via standard input and output, debugging can be challenging. This server implements comprehensive security handling and logging functions.