{"id":28926508,"url":"https://github.com/willibrandon/seq-mcp-server","last_synced_at":"2026-05-10T02:07:52.117Z","repository":{"id":300522226,"uuid":"1006281655","full_name":"willibrandon/seq-mcp-server","owner":"willibrandon","description":"A Model Context Protocol (MCP) server providing AI assistants with tools to search, stream, and analyze events from Seq structured logging servers.","archived":false,"fork":false,"pushed_at":"2025-06-22T06:38:55.000Z","size":69,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-22T07:27:43.199Z","etag":null,"topics":["ai-tools","claude-desktop","csharp","dotnet","event-streaming","logging-analysis","mcp","model-context-protocol","observability","seq","serilog","structured-logging"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/willibrandon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-21T22:44:21.000Z","updated_at":"2025-06-22T06:38:58.000Z","dependencies_parsed_at":"2025-06-22T07:38:52.935Z","dependency_job_id":null,"html_url":"https://github.com/willibrandon/seq-mcp-server","commit_stats":null,"previous_names":["willibrandon/seq-mcp-server"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/willibrandon/seq-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/willibrandon%2Fseq-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/willibrandon%2Fseq-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/willibrandon%2Fseq-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/willibrandon%2Fseq-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/willibrandon","download_url":"https://codeload.github.com/willibrandon/seq-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/willibrandon%2Fseq-mcp-server/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265568870,"owners_count":23789615,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-tools","claude-desktop","csharp","dotnet","event-streaming","logging-analysis","mcp","model-context-protocol","observability","seq","serilog","structured-logging"],"created_at":"2025-06-22T12:11:09.444Z","updated_at":"2026-05-10T02:07:52.068Z","avatar_url":"https://github.com/willibrandon.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Seq MCP Server\r\n\r\nA Model Context Protocol (MCP) server that provides tools for searching and streaming events from Seq.\r\n\r\n## Installation\r\n\r\n### As a .NET Global Tool (Recommended)\r\n\r\n```bash\r\n# Install\r\ndotnet tool install -g SeqMcpServer\r\n\r\n# Update to latest version\r\ndotnet tool update -g SeqMcpServer\r\n\r\n# Uninstall\r\ndotnet tool uninstall -g SeqMcpServer\r\n```\r\n\r\n### Requirements\r\n\r\n- .NET 9.0 Runtime or SDK\r\n- Seq server (local or remote)\r\n- Valid Seq API key\r\n\r\n## Quick Start\r\n\r\n### Development Environment\r\n\r\n```bash\r\n# Clone the repository\r\ngit clone https://github.com/willibrandon/seq-mcp-server\r\ncd seq-mcp-server\r\n\r\n# Setup development environment (fully automated)\r\n# PowerShell (Windows)\r\n./scripts/setup-dev.ps1\r\n\r\n# Bash (Linux/Mac)\r\n./scripts/setup-dev.sh\r\n\r\n# Build and run the MCP server\r\ndotnet build\r\ndotnet run --project SeqMcpServer\r\n```\r\n\r\nThe setup script automatically:\r\n- Starts a Seq container on ports 15341/18081\r\n- Configures authentication and creates an API key\r\n- Sets up environment variables\r\n- Creates a `.env` file for the application\r\n\r\n### Production Deployment\r\n\r\nMCP servers are not run directly - they are launched by MCP clients. For production:\r\n\r\n1. Build and deploy the executable:\r\n```bash\r\ndotnet publish -c Release -r win-x64 -p:PublishSingleFile=true\r\n```\r\n\r\n2. Configure your MCP client to use the deployed executable:\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"seq\": {\r\n      \"command\": \"/path/to/seq-mcp-server\",\r\n      \"env\": {\r\n        \"SEQ_SERVER_URL\": \"http://your-seq-server:5341\",\r\n        \"SEQ_API_KEY\": \"your-production-api-key\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n## MCP Tools\r\n\r\nThe following tools are available through the MCP protocol:\r\n\r\n- **`SeqSearch`** - Search Seq events with filters\r\n  - Parameters: \r\n    - `filter` (required): Seq filter expression (use empty string `\"\"` for all events)\r\n    - `count`: Number of events to return (default: 100)\r\n    - `workspace` (optional): Specific workspace to query\r\n  - Returns: List of matching events\r\n  - Example filters:\r\n    - `\"\"` - all events\r\n    - `\"error\"` - events containing \"error\"\r\n    - `@Level = \"Error\"` - error level events\r\n    - `Application = \"MyApp\"` - events from specific application\r\n\r\n- **`SeqWaitForEvents`** - Wait for and capture live events from Seq (5-second timeout)\r\n  - Parameters: \r\n    - `filter` (optional): Seq filter expression\r\n    - `count`: Number of events to capture (default: 10, max: 100)\r\n    - `workspace` (optional): Specific workspace to query\r\n  - Returns: Snapshot of events captured during the wait period (may be empty if no events match)\r\n\r\n- **`SignalList`** - List available signals (read-only)\r\n  - Parameters: \r\n    - `workspace` (optional): Specific workspace to query\r\n  - Returns: List of signals with their definitions\r\n\r\n## Claude Desktop Integration\r\n\r\n### Option 1: Using .NET Global Tool (Recommended)\r\n\r\nAfter installing the global tool, add to your Claude Desktop configuration:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"seq\": {\r\n      \"command\": \"seq-mcp-server\",\r\n      \"env\": {\r\n        \"SEQ_SERVER_URL\": \"http://localhost:5341\",\r\n        \"SEQ_API_KEY\": \"your-api-key-here\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n### Option 2: Pre-built Release\r\n\r\nDownload the latest release for your platform and add to your MCP settings:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"seq\": {\r\n      \"command\": \"C:\\\\\\\\Tools\\\\\\\\seq-mcp-server.exe\",\r\n      \"args\": [],\r\n      \"env\": {\r\n        \"SEQ_SERVER_URL\": \"http://localhost:5341\",\r\n        \"SEQ_API_KEY\": \"your-api-key-here\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n### Option 3: Build from Source\r\n\r\nBuild a single-file executable (requires .NET 9 runtime):\r\n\r\n```bash\r\n# Windows\r\ndotnet publish -c Release -r win-x64 -p:PublishSingleFile=true\r\n\r\n# macOS\r\ndotnet publish -c Release -r osx-x64 -p:PublishSingleFile=true\r\n\r\n# Linux\r\ndotnet publish -c Release -r linux-x64 -p:PublishSingleFile=true\r\n```\r\n\r\nThe executable will be in `SeqMcpServer/bin/Release/net9.0/{runtime}/publish/`\r\n\r\n## Configuration\r\n\r\nThe Seq MCP Server uses environment variables for configuration:\r\n\r\n- `SEQ_SERVER_URL`: URL of your Seq server\r\n- `SEQ_API_KEY`: API key for accessing Seq (required)\r\n- `SEQ_API_KEY_\u003cWORKSPACE\u003e`: Optional workspace-specific API keys (e.g., `SEQ_API_KEY_PRODUCTION`)\r\n\r\n### Workspace Support\r\n\r\nThe MCP server supports workspace-specific API keys (future feature):\r\n\r\n```bash\r\nexport SEQ_API_KEY=\"default-key\"\r\nexport SEQ_API_KEY_PRODUCTION=\"production-key\"\r\nexport SEQ_API_KEY_STAGING=\"staging-key\"\r\n```\r\n\r\n*Note: Workspace-specific keys are currently designed but not yet implemented in the MCP tools.*\r\n\r\n## Development\r\n\r\n### Prerequisites\r\n\r\n- .NET 9.0 SDK\r\n- Docker (for running Seq locally)\r\n\r\n### Running Tests\r\n\r\n```bash\r\ndotnet test\r\n```\r\n\r\n### Development\r\n\r\nThe `scripts` folder contains automated setup scripts:\r\n\r\n- **`setup-dev.ps1` / `setup-dev.sh`**: Automatically configures your development environment\r\n  - Starts Seq container with authentication\r\n  - Handles initial password setup\r\n  - Creates development API key\r\n  - Sets environment variables\r\n  - Creates `.env` file for the application\r\n  \r\n- **`teardown-dev.ps1` / `teardown-dev.sh`**: Cleans up the development environment\r\n  - Stops and removes containers\r\n  - Clears environment variables\r\n\r\nFor detailed development setup, see [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md).\r\n\r\n## Architecture\r\n\r\nThis is a pure MCP server implementation that:\r\n- Runs as a stdio-based service (no web server)\r\n- Communicates via JSON-RPC over standard input/output\r\n- Does not log to console to avoid interfering with MCP communication\r\n- Optionally logs to Seq itself for debugging when configured\r\n\r\n### Self-Logging\r\n\r\nThe MCP server can log its own operations to Seq when a valid `SEQ_SERVER_URL` and `SEQ_API_KEY` are provided. This helps with debugging and monitoring the MCP server itself.\r\n\r\n## License\r\n\r\nMIT License - see [LICENSE](LICENSE) file for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwillibrandon%2Fseq-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwillibrandon%2Fseq-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwillibrandon%2Fseq-mcp-server/lists"}