@last9/mcp-server 0.1.4 → 0.1.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +94 -72
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -2,20 +2,28 @@
|
|
|
2
2
|
|
|
3
3
|
|
|
4
4
|
|
|
5
|
-
A [Model Context Protocol](https://modelcontextprotocol.io/) server
|
|
5
|
+
A [Model Context Protocol](https://modelcontextprotocol.io/) server
|
|
6
|
+
implementation for [Last9](https://last9.io/mcp/) that enables AI agents to
|
|
7
|
+
seamlessly bring real-time production context — logs, metrics, and traces — into
|
|
8
|
+
your local environment to auto-fix code faster.
|
|
6
9
|
|
|
7
10
|
- [View demo](https://www.youtube.com/watch?v=AQH5xq6qzjI)
|
|
8
|
-
- Read our
|
|
11
|
+
- Read our
|
|
12
|
+
[announcement blog post](https://last9.io/blog/launching-last9-mcp-server/)
|
|
9
13
|
|
|
10
14
|
## Status
|
|
11
15
|
|
|
12
|
-
Works with Claude desktop app, or Cursor, Windsurf, and VSCode (Github Copilot)
|
|
16
|
+
Works with Claude desktop app, or Cursor, Windsurf, and VSCode (Github Copilot)
|
|
17
|
+
IDEs. Implements the following MCP
|
|
18
|
+
[tools](https://modelcontextprotocol.io/docs/concepts/tools):
|
|
13
19
|
|
|
14
|
-
- `get_exceptions`: Get list of exceptions.
|
|
20
|
+
- `get_exceptions`: Get the list of exceptions.
|
|
15
21
|
- `get_service_graph`: Get service graph for an endpoint from the exception.
|
|
16
22
|
- `get_logs`: Get logs filtered by service name and/or severity level.
|
|
17
|
-
- `get_drop_rules`: Get drop rules for logs that determine what logs get
|
|
18
|
-
|
|
23
|
+
- `get_drop_rules`: Get drop rules for logs that determine what logs get
|
|
24
|
+
filtered out at [Last9 Control Plane](https://last9.io/control-plane)
|
|
25
|
+
- `add_drop_rule`: Create a drop rule for logs at
|
|
26
|
+
[Last9 Control Plane](https://last9.io/control-plane)
|
|
19
27
|
|
|
20
28
|
## Tools Documentation
|
|
21
29
|
|
|
@@ -25,53 +33,72 @@ Retrieves server-side exceptions over a specified time range.
|
|
|
25
33
|
|
|
26
34
|
Parameters:
|
|
27
35
|
|
|
28
|
-
- `limit` (integer, optional): Maximum number of exceptions to return.
|
|
29
|
-
|
|
30
|
-
- `
|
|
31
|
-
|
|
36
|
+
- `limit` (integer, optional): Maximum number of exceptions to return.
|
|
37
|
+
Default: 20.
|
|
38
|
+
- `lookback_minutes` (integer, recommended): Number of minutes to look back from
|
|
39
|
+
now. Default: 60. Examples: 60, 30, 15.
|
|
40
|
+
- `start_time_iso` (string, optional): Start time in ISO format (YYYY-MM-DD
|
|
41
|
+
HH:MM:SS). Leave empty to use lookback_minutes.
|
|
42
|
+
- `end_time_iso` (string, optional): End time in ISO format (YYYY-MM-DD
|
|
43
|
+
HH:MM:SS). Leave empty to default to current time.
|
|
32
44
|
- `span_name` (string, optional): Name of the span to filter by.
|
|
33
45
|
|
|
34
46
|
### get_service_graph
|
|
35
47
|
|
|
36
|
-
Gets the upstream and downstream services for a given span name, along with the
|
|
48
|
+
Gets the upstream and downstream services for a given span name, along with the
|
|
49
|
+
throughput for each service.
|
|
37
50
|
|
|
38
51
|
Parameters:
|
|
39
52
|
|
|
40
53
|
- `span_name` (string, required): Name of the span to get dependencies for.
|
|
41
|
-
- `lookback_minutes` (integer, recommended): Number of minutes to look back from
|
|
42
|
-
|
|
54
|
+
- `lookback_minutes` (integer, recommended): Number of minutes to look back from
|
|
55
|
+
now. Default: 60. Examples: 60, 30, 15.
|
|
56
|
+
- `start_time_iso` (string, optional): Start time in ISO format (YYYY-MM-DD
|
|
57
|
+
HH:MM:SS). Leave empty to use lookback_minutes.
|
|
43
58
|
|
|
44
59
|
### get_logs
|
|
45
60
|
|
|
46
|
-
Gets logs filtered by optional service name and/or severity level within a
|
|
61
|
+
Gets logs filtered by optional service name and/or severity level within a
|
|
62
|
+
specified time range.
|
|
47
63
|
|
|
48
64
|
Parameters:
|
|
49
65
|
|
|
50
66
|
- `service` (string, optional): Name of the service to get logs for.
|
|
51
67
|
- `severity` (string, optional): Severity of the logs to get.
|
|
52
|
-
- `lookback_minutes` (integer, recommended): Number of minutes to look back from
|
|
53
|
-
|
|
54
|
-
- `
|
|
68
|
+
- `lookback_minutes` (integer, recommended): Number of minutes to look back from
|
|
69
|
+
now. Default: 60. Examples: 60, 30, 15.
|
|
70
|
+
- `start_time_iso` (string, optional): Start time in ISO format (YYYY-MM-DD
|
|
71
|
+
HH:MM:SS). Leave empty to use lookback_minutes.
|
|
72
|
+
- `end_time_iso` (string, optional): End time in ISO format (YYYY-MM-DD
|
|
73
|
+
HH:MM:SS). Leave empty to default to current time.
|
|
55
74
|
- `limit` (integer, optional): Maximum number of logs to return. Default: 20.
|
|
56
75
|
|
|
57
76
|
### get_drop_rules
|
|
58
77
|
|
|
59
|
-
Gets drop rules for logs, which determine what logs get filtered out from
|
|
78
|
+
Gets drop rules for logs, which determine what logs get filtered out from
|
|
79
|
+
reaching Last9.
|
|
60
80
|
|
|
61
81
|
### add_drop_rule
|
|
62
82
|
|
|
63
|
-
Adds a new drop rule to filter out specific logs at
|
|
83
|
+
Adds a new drop rule to filter out specific logs at
|
|
84
|
+
[Last9 Control Plane](https://last9.io/control-plane)
|
|
64
85
|
|
|
65
86
|
Parameters:
|
|
66
87
|
|
|
67
88
|
- `name` (string, required): Name of the drop rule.
|
|
68
|
-
- `filters` (array, required): List of filter conditions to apply. Each filter
|
|
69
|
-
|
|
89
|
+
- `filters` (array, required): List of filter conditions to apply. Each filter
|
|
90
|
+
has:
|
|
91
|
+
- `key` (string, required): The key to filter on. Only attributes and
|
|
92
|
+
resource.attributes keys are supported. For resource attributes, use format:
|
|
93
|
+
resource.attributes[key_name] and for log attributes, use format:
|
|
94
|
+
attributes[key_name] Double quotes in key names must be escaped.
|
|
70
95
|
- `value` (string, required): The value to filter against.
|
|
71
|
-
- `operator` (string, required): The operator used for filtering. Valid
|
|
96
|
+
- `operator` (string, required): The operator used for filtering. Valid
|
|
97
|
+
values:
|
|
72
98
|
- "equals"
|
|
73
99
|
- "not_equals"
|
|
74
|
-
- `conjunction` (string, required): The logical conjunction between filters.
|
|
100
|
+
- `conjunction` (string, required): The logical conjunction between filters.
|
|
101
|
+
Valid values:
|
|
75
102
|
- "and"
|
|
76
103
|
|
|
77
104
|
## Installation
|
|
@@ -102,39 +129,35 @@ npx @last9/mcp-server
|
|
|
102
129
|
|
|
103
130
|
### Environment Variables
|
|
104
131
|
|
|
105
|
-
The
|
|
132
|
+
The Last9 MCP server requires the following environment variables:
|
|
106
133
|
|
|
107
|
-
- `
|
|
108
|
-
|
|
109
|
-
- `
|
|
110
|
-
|
|
111
|
-
-
|
|
112
|
-
|
|
113
|
-
|
|
134
|
+
- `LAST9_BASE_URL`: (required) Last9 API URL from
|
|
135
|
+
[OTel integration](https://app.last9.io/integrations?integration=OpenTelemetry)
|
|
136
|
+
- `LAST9_AUTH_TOKEN`: (required) Authentication token for Last9 MCP server from
|
|
137
|
+
[OTel integration](https://app.last9.io/integrations?integration=OpenTelemetry)
|
|
138
|
+
- `LAST9_REFRESH_TOKEN`: (required) Refresh Token with Write permissions, needed
|
|
139
|
+
for accessing control plane APIs from
|
|
140
|
+
[API Access](https://app.last9.io/settings/api-access)
|
|
114
141
|
|
|
115
142
|
## Usage with Claude Desktop
|
|
116
143
|
|
|
117
144
|
Configure the Claude app to use the MCP server:
|
|
118
145
|
|
|
119
|
-
1. Open the
|
|
120
|
-
2.
|
|
121
|
-
3. Open the
|
|
146
|
+
1. Open the Claude Desktop app, go to Settings, then Developer
|
|
147
|
+
2. Click Edit Config
|
|
148
|
+
3. Open the `claude_desktop_config.json` file
|
|
122
149
|
4. Copy and paste the server config to your existing file, then save
|
|
123
150
|
5. Restart Claude
|
|
124
151
|
|
|
125
|
-
```bash
|
|
126
|
-
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
|
|
127
|
-
```
|
|
128
|
-
|
|
129
152
|
```json
|
|
130
153
|
{
|
|
131
154
|
"mcpServers": {
|
|
132
155
|
"last9": {
|
|
133
156
|
"command": "/opt/homebrew/bin/last9-mcp",
|
|
134
157
|
"env": {
|
|
135
|
-
"LAST9_AUTH_TOKEN": "<your_auth_token>",
|
|
136
158
|
"LAST9_BASE_URL": "<last9_otlp_host>",
|
|
137
|
-
"
|
|
159
|
+
"LAST9_AUTH_TOKEN": "<last9_otlp_auth_token>",
|
|
160
|
+
"LAST9_REFRESH_TOKEN": "<last9_write_refresh_token>"
|
|
138
161
|
}
|
|
139
162
|
}
|
|
140
163
|
}
|
|
@@ -145,9 +168,9 @@ code ~/Library/Application\ Support/Claude/claude_desktop_config.json
|
|
|
145
168
|
|
|
146
169
|
Configure Cursor to use the MCP server:
|
|
147
170
|
|
|
148
|
-
1.
|
|
149
|
-
2. Select
|
|
150
|
-
3. Click Add
|
|
171
|
+
1. Open Cursor, go to Settings, then Cursor Settings
|
|
172
|
+
2. Select MCP on the left
|
|
173
|
+
3. Click Add "New Global MCP Server" at the top right
|
|
151
174
|
4. Copy and paste the server config to your existing file, then save
|
|
152
175
|
5. Restart Cursor
|
|
153
176
|
|
|
@@ -157,9 +180,9 @@ Configure Cursor to use the MCP server:
|
|
|
157
180
|
"last9": {
|
|
158
181
|
"command": "/opt/homebrew/bin/last9-mcp",
|
|
159
182
|
"env": {
|
|
160
|
-
"LAST9_AUTH_TOKEN": "<auth_token>",
|
|
161
183
|
"LAST9_BASE_URL": "<last9_otlp_host>",
|
|
162
|
-
"
|
|
184
|
+
"LAST9_AUTH_TOKEN": "<last9_otlp_auth_token>",
|
|
185
|
+
"LAST9_REFRESH_TOKEN": "<last9_write_refresh_token>"
|
|
163
186
|
}
|
|
164
187
|
}
|
|
165
188
|
}
|
|
@@ -170,12 +193,11 @@ Configure Cursor to use the MCP server:
|
|
|
170
193
|
|
|
171
194
|
Configure Windsurf to use the MCP server:
|
|
172
195
|
|
|
173
|
-
1. Open
|
|
174
|
-
2.
|
|
175
|
-
3.
|
|
176
|
-
4.
|
|
177
|
-
5.
|
|
178
|
-
6. Restart Windsurf
|
|
196
|
+
1. Open Windsurf, go to Settings, then Developer
|
|
197
|
+
2. Click Edit Config
|
|
198
|
+
3. Open the `windsurf_config.json` file
|
|
199
|
+
4. Copy and paste the server config to your existing file, then save
|
|
200
|
+
5. Restart Windsurf
|
|
179
201
|
|
|
180
202
|
```json
|
|
181
203
|
{
|
|
@@ -183,9 +205,9 @@ Configure Windsurf to use the MCP server:
|
|
|
183
205
|
"last9": {
|
|
184
206
|
"command": "/opt/homebrew/bin/last9-mcp",
|
|
185
207
|
"env": {
|
|
186
|
-
"LAST9_AUTH_TOKEN": "<auth_token>",
|
|
187
208
|
"LAST9_BASE_URL": "<last9_otlp_host>",
|
|
188
|
-
"
|
|
209
|
+
"LAST9_AUTH_TOKEN": "<last9_otlp_auth_token>",
|
|
210
|
+
"LAST9_REFRESH_TOKEN": "<last9_write_refresh_token>"
|
|
189
211
|
}
|
|
190
212
|
}
|
|
191
213
|
}
|
|
@@ -194,33 +216,33 @@ Configure Windsurf to use the MCP server:
|
|
|
194
216
|
|
|
195
217
|
## Usage with VS Code
|
|
196
218
|
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
Configure VS Code to use the MCP server:
|
|
219
|
+
> Note: MCP support in VS Code is available starting v1.99 and is currently in
|
|
220
|
+
> preview. For advanced configuration options and alternative setup methods,
|
|
221
|
+
> [view the VS Code MCP documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers).
|
|
201
222
|
|
|
202
|
-
1.
|
|
223
|
+
1. Open VS Code, go to Settings, select the User tab, then Features, then Chat
|
|
224
|
+
2. Click "Edit settings.json"
|
|
225
|
+
3. Copy and paste the server config to your existing file, then save
|
|
226
|
+
4. Restart VS Code
|
|
203
227
|
|
|
204
228
|
```json
|
|
205
229
|
{
|
|
206
|
-
"
|
|
207
|
-
"
|
|
208
|
-
"
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
"
|
|
212
|
-
|
|
213
|
-
|
|
230
|
+
"mcp": {
|
|
231
|
+
"servers": {
|
|
232
|
+
"last9": {
|
|
233
|
+
"type": "stdio",
|
|
234
|
+
"command": "/opt/homebrew/bin/last9-mcp",
|
|
235
|
+
"env": {
|
|
236
|
+
"LAST9_BASE_URL": "<last9_otlp_host>",
|
|
237
|
+
"LAST9_AUTH_TOKEN": "<last9_otlp_auth_token>",
|
|
238
|
+
"LAST9_REFRESH_TOKEN": "<last9_write_refresh_token>"
|
|
239
|
+
}
|
|
214
240
|
}
|
|
215
241
|
}
|
|
216
242
|
}
|
|
217
243
|
}
|
|
218
244
|
```
|
|
219
245
|
|
|
220
|
-
|
|
221
|
-
3. Select "Agent" mode from dropdown
|
|
222
|
-
4. The Last9 MCP server will now be available in VS Code
|
|
223
|
-
|
|
224
|
-
Note: Replace placeholder values (`<auth_token>`, `<last9_otlp_host>`, and `<write_refresh_token>`) with your actual Last9 credentials.
|
|
246
|
+
## Badges
|
|
225
247
|
|
|
226
|
-
|
|
248
|
+
[](https://mseep.ai/app/last9-last9-mcp-server)
|