@last9/mcp-server 0.1.0 → 0.1.2

package/README.md

@@ -1,20 +1,83 @@
 # Last9 MCP Server
 
-A [Model Context Protocol](https://modelcontextprotocol.io/) server implementation for [Last9](https://last9.io) that enables AI agents to query your data using Last9.
+![last9 mcp demo](mcp-demo.gif)
+
+A [Model Context Protocol](https://modelcontextprotocol.io/) server implementation for [Last9](https://last9.io/mcp/) that enables AI agents to seamlessly bring real-time production context — logs, metrics, and traces — into your local environment to auto-fix code faster.
+
+- [View demo](https://www.youtube.com/watch?v=AQH5xq6qzjI)
+- Read our [announcement blog post](https://last9.io/blog/launching-last9-mcp-server/)
 
 ## Status
 
-Works with Claude desktop app. Implements two MCP [tools](https://modelcontextprotocol.io/docs/concepts/tools):
+Works with Claude desktop app, or Cursor, Windsurf, and VSCode (Github Copilot) IDEs. Implements the following MCP [tools](https://modelcontextprotocol.io/docs/concepts/tools):
+
+- `get_exceptions`: Get list of exceptions.
+- `get_service_graph`: Get service graph for an endpoint from the exception.
+- `get_logs`: Get logs filtered by service name and/or severity level.
+- `get_drop_rules`: Get drop rules for logs that determine what logs get filtered out at [Last9 Control Plane](https://last9.io/control-plane)
+- `add_drop_rule`: Create a drop rule for logs at [Last9 Control Plane](https://last9.io/control-plane)
+
+## Tools Documentation
+
+### get_exceptions
+
+Retrieves server-side exceptions over a specified time range.
+
+Parameters:
+
+- `limit` (integer, optional): Maximum number of exceptions to return. Default: 20.
+- `start_time_iso` (string, optional): Start time in ISO format (YYYY-MM-DD HH:MM:SS).
+- `end_time_iso` (string, optional): End time in ISO format (YYYY-MM-DD HH:MM:SS).
+- `span_name` (string, optional): Name of the span to filter by.
+
+### get_service_graph
+
+Gets the upstream and downstream services for a given span name, along with the throughput for each service.
+
+Parameters:
+
+- `span_name` (string, required): Name of the span to get dependencies for.
+- `lookback_minutes` (integer, optional): Number of minutes to look back. Default: 60.
+- `start_time_iso` (string, optional): Start time in ISO format (YYYY-MM-DD HH:MM:SS).
+
+### get_logs
+
+Gets logs filtered by optional service name and/or severity level within a specified time range.
+
+Parameters:
+
+- `service` (string, optional): Name of the service to get logs for.
+- `severity` (string, optional): Severity of the logs to get.
+- `start_time_iso` (string, optional): Start time in ISO format (YYYY-MM-DD HH:MM:SS).
+- `end_time_iso` (string, optional): End time in ISO format (YYYY-MM-DD HH:MM:SS).
+- `limit` (integer, optional): Maximum number of logs to return. Default: 20.
+
+### get_drop_rules
+
+Gets drop rules for logs, which determine what logs get filtered out from reaching Last9.
+
+### add_drop_rule
+
+Adds a new drop rule to filter out specific logs at [Last9 Control Plane](https://last9.io/control-plane)
 
-- get_exceptions: Get list of execeptions
-- get_servicegraph: Get Service graph for an endpoint from the exception
+Parameters:
 
+- `name` (string, required): Name of the drop rule.
+- `filters` (array, required): List of filter conditions to apply. Each filter has:
+  - `key` (string, required): The key to filter on. Only attributes and resource.attributes keys are supported. For resource attributes, use format: resource.attributes[key_name] and for log attributes, use format: attributes[key_name] Double quotes in key names must be escaped.
+  - `value` (string, required): The value to filter against.
+  - `operator` (string, required): The operator used for filtering. Valid values:
+    - "equals"
+    - "not_equals"
+  - `conjunction` (string, required): The logical conjunction between filters. Valid values:
+    - "and"
 
 ## Installation
 
-You can install the Last9 MCP server using either
+You can install the Last9 Observability MCP server using either:
 
 ### Homebrew
+
 ```
 # Add the Last9 tap
 brew tap last9/tap
@@ -41,11 +104,22 @@ The service requires the following environment variables:
 
 - `LAST9_AUTH_TOKEN`: Authentication token for Last9 MCP server (required)
 - `LAST9_BASE_URL`: Last9 API URL (required)
+- `LAST9_REFRESH_TOKEN`: Refresh Token with Write permissions. Needed for accessing control plane APIs (required).
+
+- Signup at [Last9](https://app.last9.io/) and setup one of the [integrations](https://last9.io/docs/integrations/).
+- Obtain `LAST9_BASE_URL` and `LAST9_AUTH_TOKEN` from [here](https://app.last9.io/integrations?integration=OpenTelemetry).
+- The Write Refresh Token can be obtained from [API Access](https://app.last9.io/settings/api-access) page.
 
 ## Usage with Claude Desktop
 
 Configure the Claude app to use the MCP server:
 
+1. Open the Claude Desktop app
+2. Go to Settings, then Developer, click Edit Config
+3. Open the `claude_desktop_config.json` file
+4. Copy and paste the server config to your existing file, then save
+5. Restart Claude
+
 ```bash
 code ~/Library/Application\ Support/Claude/claude_desktop_config.json
 ```
@@ -56,8 +130,9 @@ code ~/Library/Application\ Support/Claude/claude_desktop_config.json
     "last9": {
       "command": "/opt/homebrew/bin/last9-mcp",
       "env": {
-        "LAST9_AUTH_TOKEN": "your_auth_token",
-        "LAST9_BASE_URL": "https://otlp.last9.io"
+        "LAST9_AUTH_TOKEN": "<your_auth_token>",
+        "LAST9_BASE_URL": "<last9_otlp_host>",
+        "LAST9_REFRESH_TOKEN": "<refresh_token_from_last9_dashboard>"
       }
     }
   }
@@ -68,10 +143,37 @@ code ~/Library/Application\ Support/Claude/claude_desktop_config.json
 
 Configure Cursor to use the MCP server:
 
-1. Open Cursor settings
-2. Navigate to MCP
-3. Click Add New Global Configuration
-4. Add following stanza. If you already have a MCP server configured, only add the last9 stanza.
+1. Navigate to Settings, then Cursor Settings
+2. Select MCP on the left
+3. Click Add new global MCP server at the top right
+4. Copy and paste the server config to your existing file, then save
+5. Restart Cursor
+
+```json
+{
+  "mcpServers": {
+    "last9": {
+      "command": "/opt/homebrew/bin/last9-mcp",
+      "env": {
+        "LAST9_AUTH_TOKEN": "<auth_token>",
+        "LAST9_BASE_URL": "<last9_otlp_host>",
+        "LAST9_REFRESH_TOKEN": "<write_refresh_token>"
+      }
+    }
+  }
+}
+```
+
+## Usage with Windsurf
+
+Configure Cursor to use the MCP server:
+
+1. Open Windsurf
+2. Go to Settings, then Developer
+3. Click Edit Config
+4. Open the `windsurf_config.json` file
+5. Copy and paste the server config to your existing file, then save
+6. Restart Windsurf
 
 ```json
 {
@@ -79,10 +181,11 @@ Configure Cursor to use the MCP server:
     "last9": {
       "command": "/opt/homebrew/bin/last9-mcp",
       "env": {
-        "LAST9_AUTH_TOKEN": "your_auth_token",
-        "LAST9_BASE_URL": "https://otlp.last9.io"
+        "LAST9_AUTH_TOKEN": "<auth_token>",
+        "LAST9_BASE_URL": "<last9_otlp_host>",
+        "LAST9_REFRESH_TOKEN": "<refresh_token>"
       }
     }
   }
 }
-```
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@last9/mcp-server",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Last9 MCP Server - Model Context Protocol server implementation for Last9",
   "bin": {
     "last9-mcp": "./bin/cli.js"
@@ -13,8 +13,7 @@
   ],
   "scripts": {
     "postinstall": "node bin/download-binary.js",
-    "preversion": "go run main.go --version",
-    "postversion": "git push && git push --tags"
+    "preversion": "go run . --version"
   },
   "repository": {
     "type": "git",
@@ -24,7 +23,12 @@
     "node": ">=14"
   },
   "preferGlobal": true,
-  "keywords": ["last9", "mcp", "ai", "claude"],
+  "keywords": [
+    "last9",
+    "mcp",
+    "ai",
+    "claude"
+  ],
   "author": "Last9",
   "license": "MIT",
   "bugs": {
@@ -34,4 +38,4 @@
   "publishConfig": {
     "access": "public"
   }
-} 
+}