https://github.com/last9/last9-mcp-server
Last9 MCP Server
https://github.com/last9/last9-mcp-server
claude cursor mcp monitoring observability vibe-coding
Last synced: 17 days ago
JSON representation
Last9 MCP Server
- Host: GitHub
- URL: https://github.com/last9/last9-mcp-server
- Owner: last9
- Created: 2025-03-28T01:46:45.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-04-20T06:41:44.000Z (20 days ago)
- Last Synced: 2025-04-23T12:06:15.384Z (17 days ago)
- Topics: claude, cursor, mcp, monitoring, observability, vibe-coding
- Language: Go
- Homepage: https://last9.io/mcp
- Size: 8.58 MB
- Stars: 29
- Watchers: 5
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-devops-mcp-servers - last9/last9-mcp-server - Last9 MCP Server for observability and monitoring, providing AI assistants with access to metrics, logs, and traces. (Monitoring & Observability / 🔍 Application Performance Monitoring)
- awesome-devops-mcp-servers - last9/last9-mcp-server - Last9 MCP Server for observability and monitoring, providing AI assistants with access to metrics, logs, and traces. (Monitoring & Observability / 🔍 Application Performance Monitoring)
- awesome-mcp-servers - Last9 MCP Server - Provides real-time production context (logs, metrics, traces) to AI agents for faster code debugging (Table of Contents / Developer Tools)
- awesome-mcp-servers - Last9 MCP Server - Provides real-time production context (logs, metrics, traces) to AI agents for faster code debugging (Table of Contents / Developer Tools)
- awesome-mcp-servers - Last9 - Seamlessly bring real-time production context—logs, metrics, and traces—into your local environment to auto-fix code faster. (Official Servers)
README
# Last9 MCP Server
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, 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.
- `lookback_minutes` (integer, recommended): Number of minutes to look back from now. Default: 60. Examples: 60, 30, 15.
- `start_time_iso` (string, optional): Start time in ISO format (YYYY-MM-DD HH:MM:SS). Leave empty to use lookback_minutes.
- `end_time_iso` (string, optional): End time in ISO format (YYYY-MM-DD HH:MM:SS). Leave empty to default to current time.
- `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, recommended): Number of minutes to look back from now. Default: 60. Examples: 60, 30, 15.
- `start_time_iso` (string, optional): Start time in ISO format (YYYY-MM-DD HH:MM:SS). Leave empty to use lookback_minutes.
### 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.
- `lookback_minutes` (integer, recommended): Number of minutes to look back from now. Default: 60. Examples: 60, 30, 15.
- `start_time_iso` (string, optional): Start time in ISO format (YYYY-MM-DD HH:MM:SS). Leave empty to use lookback_minutes.
- `end_time_iso` (string, optional): End time in ISO format (YYYY-MM-DD HH:MM:SS). Leave empty to default to current time.
- `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)
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 Observability MCP server using either:
### Homebrew
```
# Add the Last9 tap
brew tap last9/tap
# Install the Last9 MCP CLI
brew install last9-mcp
```
### NPM
```bash
# Install globally
npm install -g @last9/mcp-server
# Or run directly with npx
npx @last9/mcp-server
```
## Configuration
### Environment Variables
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
```
```json
{
"mcpServers": {
"last9": {
"command": "/opt/homebrew/bin/last9-mcp",
"env": {
"LAST9_AUTH_TOKEN": "",
"LAST9_BASE_URL": "",
"LAST9_REFRESH_TOKEN": ""
}
}
}
}
```
## Usage with Cursor
Configure Cursor to use the MCP server:
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": "",
"LAST9_BASE_URL": "",
"LAST9_REFRESH_TOKEN": ""
}
}
}
}
```
## Usage with Windsurf
Configure Windsurf 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
{
"mcpServers": {
"last9": {
"command": "/opt/homebrew/bin/last9-mcp",
"env": {
"LAST9_AUTH_TOKEN": "",
"LAST9_BASE_URL": "",
"LAST9_REFRESH_TOKEN": ""
}
}
}
}
```
## Usage with VS Code
Prerequisites:
- VS Code version 1.99 or later
Configure VS Code to use the MCP server:
1. Create `.vscode/mcp.json` in your workspace or add to VS Code user settings with the following configuration:
```json
{
"servers": {
"last9": {
"type": "stdio",
"command": "/opt/homebrew/bin/last9-mcp",
"env": {
"LAST9_AUTH_TOKEN": "",
"LAST9_BASE_URL": "",
"LAST9_REFRESH_TOKEN": ""
}
}
}
}
```
2. Open Chat view (⌃⌘I on macOS, Ctrl+Alt+I on Windows/Linux)
3. Select "Agent" mode from dropdown
4. The Last9 MCP server will now be available in VS Code
Note: Replace placeholder values (``, ``, and ``) with your actual Last9 credentials.
For advanced configuration options and alternative setup methods, see the [official VS Code MCP documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers).