strayl-mcp-server 0.1.3__py3-none-any.whl

strayl_mcp_server/__init__.py

@@ -0,0 +1,3 @@
+"""Strayl MCP Server - MCP server for log search."""
+
+__version__ = "0.1.0"

strayl_mcp_server/__main__.py

@@ -0,0 +1,12 @@
+"""Entry point for the Strayl MCP server."""
+
+from .server import mcp
+
+
+def main():
+    """Run the Strayl MCP server."""
+    mcp.run()
+
+
+if __name__ == "__main__":
+    main()

strayl_mcp_server/server.py

@@ -0,0 +1,265 @@
+"""Strayl MCP Server - Log search tools."""
+
+import os
+from typing import Annotated, Optional
+import httpx
+from mcp.server.fastmcp import FastMCP
+
+from .utils import parse_time_period, format_log_result
+
+# Initialize FastMCP server
+mcp = FastMCP(
+    "Strayl Log Search",
+    dependencies=[
+        "httpx>=0.27.0",
+        "python-dateutil>=2.8.0",
+    ]
+)
+
+
+# Strayl API base URL (hardcoded)
+STRAYL_API_URL = "https://ougtygyvcgdnytkswier.supabase.co/functions/v1"
+
+
+def get_api_key() -> str:
+    """Get API key from environment variable."""
+    api_key = os.getenv("STRAYL_API_KEY", "")
+
+    if not api_key:
+        raise ValueError(
+            "STRAYL_API_KEY environment variable is required. "
+            "Get your API key from https://strayl.dev"
+        )
+
+    return api_key
+
+
+@mcp.tool()
+async def search_logs_semantic(
+    query: Annotated[str, "Search query in natural language or keywords"],
+    time_period: Annotated[Optional[str], "Time filter: 5m, 1h, today, yesterday, 7d, 30d, etc."] = None,
+    match_threshold: Annotated[float, "Minimum similarity score (0.0 to 1.0)"] = 0.2,
+    match_count: Annotated[int, "Maximum number of results to return"] = 50,
+) -> str:
+    """Search logs using semantic (vector) search with optional time filtering.
+
+    This tool performs AI-powered semantic search across your logs, finding relevant entries
+    even if they don't contain exact keywords."""
+    try:
+        api_key = get_api_key()
+
+        # Parse time period if provided
+        start_time = None
+        end_time = None
+        if time_period:
+            start_time, end_time = parse_time_period(time_period)
+            if start_time is None:
+                return f"Error: Invalid time period '{time_period}'. Supported values: 5m, 1h, today, yesterday, 7d, etc."
+
+        # Prepare request payload
+        payload = {
+            "query": query,
+            "match_threshold": match_threshold,
+            "match_count": match_count,
+        }
+
+        # Add time filters if provided
+        if start_time:
+            payload["start_time"] = start_time.isoformat()
+        if end_time:
+            payload["end_time"] = end_time.isoformat()
+
+        # Make API request
+        async with httpx.AsyncClient(timeout=30.0) as client:
+            response = await client.post(
+                f"{STRAYL_API_URL}/search-logs",
+                json=payload,
+                headers={
+                    "Authorization": f"Bearer {api_key}",
+                    "Content-Type": "application/json",
+                },
+            )
+
+            if response.status_code != 200:
+                error_data = response.json() if response.headers.get("content-type") == "application/json" else {}
+                return f"Error: API returned status {response.status_code}: {error_data.get('error', response.text)}"
+
+            data = response.json()
+
+            if not data.get("success"):
+                return f"Error: {data.get('error', 'Unknown error')}"
+
+            results = data.get("results", [])
+            total = data.get("total_results", 0)
+            metadata = data.get("search_metadata", {})
+
+            if not results:
+                time_info = f" in period '{time_period}'" if time_period else ""
+                return f"No logs found for query '{query}'{time_info}"
+
+            # Format results
+            output = [
+                f"Semantic Search Results for: '{query}'",
+                f"Total results: {total}",
+            ]
+
+            if time_period:
+                output.append(f"Time period: {time_period}")
+
+            output.append(f"Similarity threshold: {match_threshold}")
+            output.append(f"Logs with embeddings: {metadata.get('logs_with_embeddings', 0)}")
+            output.append("\n" + "=" * 80 + "\n")
+
+            for i, log in enumerate(results[:10], 1):
+                output.append(f"{i}. {format_log_result(log)}")
+                output.append("-" * 80)
+
+            if total > 10:
+                output.append(f"\n... and {total - 10} more results")
+
+            return "\n".join(output)
+
+    except ValueError as e:
+        return f"Configuration error: {str(e)}"
+    except httpx.TimeoutException:
+        return "Error: Request timed out. Please try again."
+    except Exception as e:
+        return f"Error: {str(e)}"
+
+
+@mcp.tool()
+async def search_logs_exact(
+    query: Annotated[str, "Exact text to search for. Use '*' or empty string to see all logs"],
+    time_period: Annotated[Optional[str], "Time filter: 5m, 1h, today, yesterday, 7d, 30d, etc."] = None,
+    level: Annotated[Optional[str], "Log level filter: info, warn, error, debug"] = None,
+    case_sensitive: Annotated[bool, "Whether to perform case-sensitive search"] = False,
+    limit: Annotated[int, "Maximum number of results to return"] = 50,
+) -> str:
+    """Search logs using exact text matching with optional time and level filtering.
+
+    This tool performs exact text search across your logs. Use '*' as query to view all logs
+    with optional filters by time period and log level."""
+    try:
+        api_key = get_api_key()
+
+        # Parse time period if provided
+        start_time = None
+        end_time = None
+        if time_period:
+            start_time, end_time = parse_time_period(time_period)
+            if start_time is None:
+                return f"Error: Invalid time period '{time_period}'"
+
+        # Prepare request payload
+        payload = {
+            "query": query,
+            "case_sensitive": case_sensitive,
+            "limit": limit,
+        }
+
+        if level:
+            if level.lower() not in ["info", "warn", "error", "debug"]:
+                return f"Error: Invalid log level '{level}'. Must be one of: info, warn, error, debug"
+            payload["level"] = level.lower()
+
+        if start_time:
+            payload["start_time"] = start_time.isoformat()
+        if end_time:
+            payload["end_time"] = end_time.isoformat()
+
+        # Make API request to exact search endpoint
+        async with httpx.AsyncClient(timeout=30.0) as client:
+            response = await client.post(
+                f"{STRAYL_API_URL}/exact-search-logs",
+                json=payload,
+                headers={
+                    "Authorization": f"Bearer {api_key}",
+                    "Content-Type": "application/json",
+                },
+            )
+
+            if response.status_code != 200:
+                error_data = response.json() if response.headers.get("content-type") == "application/json" else {}
+                return f"Error: API returned status {response.status_code}: {error_data.get('error', response.text)}"
+
+            data = response.json()
+
+            if not data.get("success"):
+                return f"Error: {data.get('error', 'Unknown error')}"
+
+            results = data.get("results", [])
+            total = data.get("total_results", 0)
+
+            if not results:
+                filters = []
+                if time_period:
+                    filters.append(f"period '{time_period}'")
+                if level:
+                    filters.append(f"level '{level}'")
+                filter_str = f" with filters: {', '.join(filters)}" if filters else ""
+                return f"No logs found for exact text '{query}'{filter_str}"
+
+            # Format results
+            output = [
+                f"Exact Search Results for: '{query}'",
+                f"Total results: {total}",
+            ]
+
+            if time_period:
+                output.append(f"Time period: {time_period}")
+            if level:
+                output.append(f"Log level: {level}")
+
+            output.append(f"Case sensitive: {case_sensitive}")
+            output.append("\n" + "=" * 80 + "\n")
+
+            for i, log in enumerate(results[:10], 1):
+                output.append(f"{i}. {format_log_result(log)}")
+                output.append("-" * 80)
+
+            if total > 10:
+                output.append(f"\n... and {total - 10} more results")
+
+            return "\n".join(output)
+
+    except ValueError as e:
+        return f"Configuration error: {str(e)}"
+    except httpx.TimeoutException:
+        return "Error: Request timed out. Please try again."
+    except Exception as e:
+        return f"Error: {str(e)}"
+
+
+@mcp.tool()
+def list_time_periods() -> str:
+    """
+    List all supported time period formats for log search.
+
+    Returns:
+        A formatted list of all supported time period values
+    """
+    return """Supported time periods for log search:
+
+Minutes:
+  - 5m, 5_minutes, 5_mins - Last 5 minutes
+  - 10m, 10_minutes - Last 10 minutes
+  - 15m, 15_minutes - Last 15 minutes
+  - 30m, 30_minutes - Last 30 minutes
+
+Hours:
+  - 1h, 1_hour - Last 1 hour
+  - 2h, 2_hours - Last 2 hours
+  - 6h, 6_hours - Last 6 hours
+  - 12h, 12_hours - Last 12 hours
+  - 24h, last_24_hours - Last 24 hours
+
+Days:
+  - today - Today from 00:00 UTC
+  - yesterday - Full yesterday (00:00 to 23:59)
+  - 7d, last_7_days - Last 7 days
+  - 30d, last_30_days - Last 30 days
+
+Examples:
+  - search_logs_semantic("error connecting to database", "1h")
+  - search_logs_exact("timeout", "today", level="error")
+"""

strayl_mcp_server/utils.py

@@ -0,0 +1,81 @@
+"""Utility functions for the Strayl MCP server."""
+
+from datetime import datetime, timedelta
+from typing import Optional, Tuple
+
+
+def parse_time_period(period: str) -> Tuple[Optional[datetime], Optional[datetime]]:
+    """
+    Parse time period strings and return start/end datetime.
+
+    Supported periods:
+    - "5_minutes", "5_mins", "5m" - last 5 minutes
+    - "1_hour", "1h" - last 1 hour
+    - "today" - today from 00:00
+    - "yesterday" - yesterday's full day
+    - "last_24_hours", "24h" - last 24 hours
+    - "last_7_days", "7d" - last 7 days
+    - "last_30_days", "30d" - last 30 days
+
+    Returns:
+        Tuple of (start_time, end_time) as datetime objects, or (None, None) if invalid
+    """
+    now = datetime.utcnow()
+    period = period.lower().strip()
+
+    # Minutes
+    if period in ["5_minutes", "5_mins", "5m"]:
+        return now - timedelta(minutes=5), now
+    elif period in ["10_minutes", "10_mins", "10m"]:
+        return now - timedelta(minutes=10), now
+    elif period in ["15_minutes", "15_mins", "15m"]:
+        return now - timedelta(minutes=15), now
+    elif period in ["30_minutes", "30_mins", "30m"]:
+        return now - timedelta(minutes=30), now
+
+    # Hours
+    elif period in ["1_hour", "1h"]:
+        return now - timedelta(hours=1), now
+    elif period in ["2_hours", "2h"]:
+        return now - timedelta(hours=2), now
+    elif period in ["6_hours", "6h"]:
+        return now - timedelta(hours=6), now
+    elif period in ["12_hours", "12h"]:
+        return now - timedelta(hours=12), now
+    elif period in ["last_24_hours", "24h"]:
+        return now - timedelta(hours=24), now
+
+    # Days
+    elif period == "today":
+        start_of_day = now.replace(hour=0, minute=0, second=0, microsecond=0)
+        return start_of_day, now
+    elif period == "yesterday":
+        yesterday = now - timedelta(days=1)
+        start_of_yesterday = yesterday.replace(hour=0, minute=0, second=0, microsecond=0)
+        end_of_yesterday = start_of_yesterday + timedelta(days=1) - timedelta(microseconds=1)
+        return start_of_yesterday, end_of_yesterday
+    elif period in ["last_7_days", "7d"]:
+        return now - timedelta(days=7), now
+    elif period in ["last_30_days", "30d"]:
+        return now - timedelta(days=30), now
+
+    # Invalid period
+    return None, None
+
+
+def format_log_result(log: dict) -> str:
+    """Format a log entry for display."""
+    timestamp = log.get("created_at", "Unknown time")
+    level = log.get("level", "info").upper()
+    message = log.get("message", "")
+    context = log.get("context", {})
+
+    result = f"[{timestamp}] [{level}] {message}"
+
+    if context:
+        result += f"\nContext: {context}"
+
+    if "similarity" in log:
+        result += f"\nSimilarity: {log['similarity']:.4f}"
+
+    return result

strayl_mcp_server-0.1.3.dist-info/METADATA

@@ -0,0 +1,237 @@
+Metadata-Version: 2.4
+Name: strayl-mcp-server
+Version: 0.1.3
+Summary: MCP server for Strayl log search with semantic and exact search capabilities
+Project-URL: Homepage, https://strayl.dev
+Project-URL: Documentation, https://docs.strayl.dev
+Project-URL: Repository, https://github.com/strayl/strayl-mcp-server
+Project-URL: Issues, https://github.com/strayl/strayl-mcp-server/issues
+Author-email: Strayl <support@strayl.dev>
+License: MIT
+License-File: LICENSE
+Keywords: ai,logging,mcp,search,strayl
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp>=0.9.0
+Requires-Dist: python-dateutil>=2.8.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Strayl MCP Server
+
+MCP server for semantic and exact log search powered by Strayl.
+
+## Features
+
+- **Semantic Search**: AI-powered search across your logs using vector embeddings
+- **Exact Text Search**: Traditional text matching with case-sensitive options
+- **Time Filtering**: Search logs by time periods (5m, 1h, today, yesterday, 7d, etc.)
+- **Log Level Filtering**: Filter by log levels (info, warn, error, debug)
+- **Easy Integration**: Works with Claude Desktop, Cline, and other MCP clients
+
+## Installation
+
+Install via pipx (recommended):
+
+```bash
+pipx install strayl-mcp-server
+```
+
+Or via pip:
+
+```bash
+pip install strayl-mcp-server
+```
+
+## Configuration
+
+### Get Your API Key
+
+1. Visit [https://strayl.dev](https://strayl.dev)
+2. Generate an API key
+3. Copy your API key (starts with `st_`)
+
+### Claude Desktop Configuration
+
+Add to your Claude Desktop config file:
+
+**MacOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "strayl": {
+      "command": "pipx",
+      "args": ["run", "--no-cache", "strayl-mcp-server"],
+      "env": {
+        "STRAYL_API_KEY": "your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+### Cline/Other MCP Clients
+
+Add to your MCP settings file:
+
+```json
+{
+  "mcpServers": {
+    "strayl": {
+      "command": "pipx",
+      "args": ["run", "--no-cache", "strayl-mcp-server"],
+      "env": {
+        "STRAYL_API_KEY": "your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+## Available Tools
+
+### 1. search_logs_semantic
+
+Semantic (AI-powered) search across your logs.
+
+**Parameters:**
+- `query` (required): Search query in natural language
+- `time_period` (optional): Time filter (e.g., "5m", "1h", "today", "7d")
+- `match_threshold` (optional): Similarity threshold (0.0-1.0, default 0.5)
+- `match_count` (optional): Max results (default 50)
+
+**Example:**
+```
+Search for database connection errors in the last hour
+```
+
+### 2. search_logs_exact
+
+Exact text matching search across your logs.
+
+**Parameters:**
+- `query` (required): Exact text to search for
+- `time_period` (optional): Time filter
+- `level` (optional): Log level filter ("info", "warn", "error", "debug")
+- `case_sensitive` (optional): Case-sensitive search (default false)
+- `limit` (optional): Max results (default 50)
+
+**Example:**
+```
+Search for exact text "timeout" in error logs from today
+```
+
+### 3. list_time_periods
+
+List all supported time period formats.
+
+## Time Period Formats
+
+### Minutes
+- `5m`, `5_minutes`, `5_mins` - Last 5 minutes
+- `10m`, `15m`, `30m` - Last 10, 15, 30 minutes
+
+### Hours
+- `1h`, `2h`, `6h`, `12h` - Last 1, 2, 6, 12 hours
+- `24h`, `last_24_hours` - Last 24 hours
+
+### Days
+- `today` - Today from 00:00 UTC
+- `yesterday` - Full yesterday
+- `7d`, `last_7_days` - Last 7 days
+- `30d`, `last_30_days` - Last 30 days
+
+## Usage Examples
+
+### With Claude Desktop
+
+Simply ask Claude:
+
+> "Search my logs for authentication errors in the last hour"
+
+> "Find all database connection issues from today"
+
+> "Show me exact text 'null pointer' in error logs"
+
+### Development/Testing
+
+Run the server directly:
+
+```bash
+export STRAYL_API_KEY="your_api_key_here"
+strayl-mcp-server
+```
+
+## Logging Your Application
+
+To send logs to Strayl, use the Strayl Log API:
+
+```python
+import httpx
+
+api_key = "st_your_api_key"
+api_url = "https://ougtygyvcgdnytkswier.supabase.co/functions/v1"
+
+async def log_message(message: str, level: str = "info", context: dict = None):
+    async with httpx.AsyncClient() as client:
+        await client.post(
+            f"{api_url}/log",
+            json={
+                "message": message,
+                "level": level,
+                "context": context or {}
+            },
+            headers={"Authorization": f"Bearer {api_key}"}
+        )
+
+# Usage
+await log_message("User logged in", "info", {"user_id": "123"})
+await log_message("Database connection failed", "error", {"db": "postgres"})
+```
+
+## Troubleshooting
+
+### API Key Issues
+
+If you get authentication errors:
+1. Verify your API key starts with `st_`
+2. Check the API key is correctly set in your MCP config
+3. Ensure there are no extra spaces or quotes around the key
+
+### Connection Issues
+
+If the server fails to connect:
+1. Check your internet connection
+2. Verify the Strayl API is accessible
+3. Check for any firewall or proxy issues
+
+### No Results
+
+If searches return no results:
+1. Verify you've sent logs to Strayl
+2. Check the time period filter isn't too restrictive
+3. For semantic search, wait a few seconds for embeddings to generate
+
+## Support
+
+- Documentation: [https://docs.strayl.dev](https://docs.strayl.dev)
+- Issues: [https://github.com/strayl/strayl-mcp-server/issues](https://github.com/strayl/strayl-mcp-server/issues)
+- Website: [https://strayl.dev](https://strayl.dev)
+
+## License
+
+MIT License

strayl_mcp_server-0.1.3.dist-info/RECORD

@@ -0,0 +1,9 @@
+strayl_mcp_server/__init__.py,sha256=YlZZgEDWLnSP-LyCqePauNh5Az83gQwr8r-f3p2Qvt8,76
+strayl_mcp_server/__main__.py,sha256=NjGxwuqovfeHDFoPaZ1Q7n_B21rufsCKs0BYR1S2GfU,175
+strayl_mcp_server/server.py,sha256=R_DI3jaP1DMKaMGaSY9ZWZK_n0gYDzB0DlOCKqsZ1iU,9136
+strayl_mcp_server/utils.py,sha256=3AnU2_xbgY4V4qYZrz5oeFlVillfuL7_y6HHmp2eSV0,2778
+strayl_mcp_server-0.1.3.dist-info/METADATA,sha256=LkWCc7BqgLscqOW6l0OPXAwplipdzIBNmr_WP0P8qPU,6045
+strayl_mcp_server-0.1.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+strayl_mcp_server-0.1.3.dist-info/entry_points.txt,sha256=vWFdsH9LlqPHhksTI_cXM1s23TPayuAsAimjHmikhZI,70
+strayl_mcp_server-0.1.3.dist-info/licenses/LICENSE,sha256=tFZq-Op9ait9HfpxRqREcfdp3NoUZAX2PalftrBG_3c,1063
+strayl_mcp_server-0.1.3.dist-info/RECORD,,

strayl_mcp_server-0.1.3.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any

strayl_mcp_server-0.1.3.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+strayl-mcp-server = strayl_mcp_server.__main__:main

strayl_mcp_server-0.1.3.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Strayl
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.