@daanrongen/grafana-mcp 1.1.0 → 1.2.1

package/dist/main.js

@@ -36769,7 +36769,7 @@ class AlertInstance extends exports_Schema.Class("AlertInstance")({
 class Folder extends exports_Schema.Class("Folder")({
   uid: exports_Schema.String,
   title: exports_Schema.String,
-  url: exports_Schema.String
+  url: exports_Schema.optional(exports_Schema.String)
 }) {
 }
 
@@ -36841,7 +36841,7 @@ var AlertInstanceSchema = exports_Schema.Struct({
 var FolderSchema = exports_Schema.Struct({
   uid: exports_Schema.String,
   title: exports_Schema.String,
-  url: exports_Schema.String
+  url: exports_Schema.optional(exports_Schema.String)
 });
 var AnnotationSchema = exports_Schema.Struct({
   id: exports_Schema.Number,
@@ -44647,17 +44647,35 @@ var runTool = async (runtime5, effect2) => {
 
 // src/mcp/tools/alerts.ts
 var registerAlertTools = (server, runtime5) => {
-  server.tool("list_alert_rules", "List all Grafana alert rules. Returns uid, title, condition, folder, rule group, and state settings.", {}, { title: "List Alert Rules", readOnlyHint: true, openWorldHint: true }, () => runTool(runtime5, exports_Effect.gen(function* () {
+  server.tool("list_alert_rules", "List all Grafana alert rules. Returns uid, title, condition, folder, rule group, and state settings.", {}, {
+    title: "List Alert Rules",
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  }, () => runTool(runtime5, exports_Effect.gen(function* () {
     const client = yield* GrafanaClient;
     return yield* client.listAlertRules();
   })));
   server.tool("get_alert_rule", "Get a Grafana alert rule by UID.", {
     uid: exports_external.string().describe("Alert rule UID")
-  }, { title: "Get Alert Rule", readOnlyHint: true, openWorldHint: true }, ({ uid }) => runTool(runtime5, exports_Effect.gen(function* () {
+  }, {
+    title: "Get Alert Rule",
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  }, ({ uid }) => runTool(runtime5, exports_Effect.gen(function* () {
     const client = yield* GrafanaClient;
     return yield* client.getAlertRule(uid);
   })));
-  server.tool("list_alert_instances", "List currently firing Grafana alert instances from Alertmanager. Returns labels, state, and activeAt.", {}, { title: "List Alert Instances", readOnlyHint: true, openWorldHint: true }, () => runTool(runtime5, exports_Effect.gen(function* () {
+  server.tool("list_alert_instances", "List currently firing Grafana alert instances from Alertmanager. Returns labels, state, and activeAt.", {}, {
+    title: "List Alert Instances",
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  }, () => runTool(runtime5, exports_Effect.gen(function* () {
     const client = yield* GrafanaClient;
     return yield* client.listAlertInstances();
   })));
@@ -44668,13 +44686,19 @@ var registerAnnotationTools = (server, runtime5) => {
   server.tool("list_annotations", "List Grafana annotations, optionally filtered by dashboard UID.", {
     dashboardUid: exports_external.string().optional().describe("Filter annotations by dashboard UID"),
     limit: exports_external.number().optional().describe("Maximum number of results (default: 100)")
-  }, { title: "List Annotations", readOnlyHint: true, openWorldHint: true }, ({ dashboardUid, limit }) => runTool(runtime5, exports_Effect.gen(function* () {
+  }, {
+    title: "List Annotations",
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  }, ({ dashboardUid, limit }) => runTool(runtime5, exports_Effect.gen(function* () {
     const client = yield* GrafanaClient;
     return yield* client.listAnnotations(dashboardUid, limit);
   })));
   server.tool("create_annotation", "Create a Grafana annotation, optionally pinned to a dashboard.", {
     text: exports_external.string().describe("Annotation text / description"),
-    tags: exports_external.array(exports_external.string()).describe("Tags to attach to the annotation"),
+    tags: exports_external.union([exports_external.array(exports_external.string()), exports_external.string().transform((s) => JSON.parse(s))]).describe("Tags to attach to the annotation"),
     dashboardUid: exports_external.string().optional().describe("Dashboard UID to attach the annotation to"),
     time: exports_external.number().optional().describe("Epoch time in milliseconds (default: now)"),
     timeEnd: exports_external.number().optional().describe("End epoch time in milliseconds for a time-range annotation")
@@ -44682,6 +44706,7 @@ var registerAnnotationTools = (server, runtime5) => {
     title: "Create Annotation",
     readOnlyHint: false,
     destructiveHint: false,
+    idempotentHint: false,
     openWorldHint: true
   }, ({ text, tags, dashboardUid, time: time3, timeEnd }) => runTool(runtime5, exports_Effect.gen(function* () {
     const client = yield* GrafanaClient;
@@ -44694,13 +44719,25 @@ var registerDashboardTools = (server, runtime5) => {
   server.tool("list_dashboards", "Search and list Grafana dashboards. Returns uid, title, url, folderTitle, and tags.", {
     query: exports_external.string().optional().describe("Search query to filter dashboards by title"),
     limit: exports_external.number().optional().describe("Maximum number of results (default: 100)")
-  }, { title: "List Dashboards", readOnlyHint: true, openWorldHint: true }, ({ query, limit }) => runTool(runtime5, exports_Effect.gen(function* () {
+  }, {
+    title: "List Dashboards",
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  }, ({ query, limit }) => runTool(runtime5, exports_Effect.gen(function* () {
     const client = yield* GrafanaClient;
     return yield* client.listDashboards(query, limit);
   })));
   server.tool("get_dashboard", "Get a Grafana dashboard by UID. Returns full dashboard JSON, version, and folder.", {
     uid: exports_external.string().describe("Dashboard UID")
-  }, { title: "Get Dashboard", readOnlyHint: true, openWorldHint: true }, ({ uid }) => runTool(runtime5, exports_Effect.gen(function* () {
+  }, {
+    title: "Get Dashboard",
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  }, ({ uid }) => runTool(runtime5, exports_Effect.gen(function* () {
     const client = yield* GrafanaClient;
     return yield* client.getDashboard(uid);
   })));
@@ -44708,7 +44745,13 @@ var registerDashboardTools = (server, runtime5) => {
     dashboardJson: exports_external.string().describe("Dashboard JSON as a string (must include at minimum a 'title' field)"),
     folderUid: exports_external.string().optional().describe("UID of the folder to place the dashboard in"),
     message: exports_external.string().optional().describe("Commit message for the dashboard version")
-  }, { title: "Create Dashboard", readOnlyHint: false, destructiveHint: false, openWorldHint: true }, ({ dashboardJson, folderUid, message }) => runTool(runtime5, exports_Effect.gen(function* () {
+  }, {
+    title: "Create Dashboard",
+    readOnlyHint: false,
+    destructiveHint: false,
+    idempotentHint: false,
+    openWorldHint: true
+  }, ({ dashboardJson, folderUid, message }) => runTool(runtime5, exports_Effect.gen(function* () {
     const client = yield* GrafanaClient;
     return yield* client.createDashboard(dashboardJson, folderUid, message);
   })));
@@ -44716,13 +44759,25 @@ var registerDashboardTools = (server, runtime5) => {
     uid: exports_external.string().describe("Dashboard UID"),
     dashboardJson: exports_external.string().describe("Updated dashboard JSON as a string"),
     message: exports_external.string().optional().describe("Commit message for the new version")
-  }, { title: "Update Dashboard", readOnlyHint: false, destructiveHint: false, openWorldHint: true }, ({ uid, dashboardJson, message }) => runTool(runtime5, exports_Effect.gen(function* () {
+  }, {
+    title: "Update Dashboard",
+    readOnlyHint: false,
+    destructiveHint: false,
+    idempotentHint: false,
+    openWorldHint: true
+  }, ({ uid, dashboardJson, message }) => runTool(runtime5, exports_Effect.gen(function* () {
     const client = yield* GrafanaClient;
     return yield* client.updateDashboard(uid, dashboardJson, message);
   })));
   server.tool("delete_dashboard", "Delete a Grafana dashboard by UID.", {
     uid: exports_external.string().describe("Dashboard UID")
-  }, { title: "Delete Dashboard", readOnlyHint: false, destructiveHint: true, openWorldHint: true }, ({ uid }) => runTool(runtime5, exports_Effect.gen(function* () {
+  }, {
+    title: "Delete Dashboard",
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: true,
+    openWorldHint: true
+  }, ({ uid }) => runTool(runtime5, exports_Effect.gen(function* () {
     const client = yield* GrafanaClient;
     yield* client.deleteDashboard(uid);
     return { ok: true };
@@ -44731,13 +44786,25 @@ var registerDashboardTools = (server, runtime5) => {
 
 // src/mcp/tools/datasources.ts
 var registerDatasourceTools = (server, runtime5) => {
-  server.tool("list_datasources", "List all configured Grafana datasources. Returns id, uid, name, type, url, and isDefault.", {}, { title: "List Datasources", readOnlyHint: true, openWorldHint: true }, () => runTool(runtime5, exports_Effect.gen(function* () {
+  server.tool("list_datasources", "List all configured Grafana datasources. Returns id, uid, name, type, url, and isDefault.", {}, {
+    title: "List Datasources",
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  }, () => runTool(runtime5, exports_Effect.gen(function* () {
     const client = yield* GrafanaClient;
     return yield* client.listDatasources();
   })));
   server.tool("get_datasource", "Get a Grafana datasource by UID.", {
     uid: exports_external.string().describe("Datasource UID")
-  }, { title: "Get Datasource", readOnlyHint: true, openWorldHint: true }, ({ uid }) => runTool(runtime5, exports_Effect.gen(function* () {
+  }, {
+    title: "Get Datasource",
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  }, ({ uid }) => runTool(runtime5, exports_Effect.gen(function* () {
     const client = yield* GrafanaClient;
     return yield* client.getDatasource(uid);
   })));
@@ -44750,6 +44817,7 @@ var registerDatasourceTools = (server, runtime5) => {
     title: "Create Datasource",
     readOnlyHint: false,
     destructiveHint: false,
+    idempotentHint: false,
     openWorldHint: true
   }, ({ name, type, url: url3, isDefault }) => runTool(runtime5, exports_Effect.gen(function* () {
     const client = yield* GrafanaClient;
@@ -44757,7 +44825,13 @@ var registerDatasourceTools = (server, runtime5) => {
   })));
   server.tool("delete_datasource", "Delete a Grafana datasource by UID.", {
     uid: exports_external.string().describe("Datasource UID")
-  }, { title: "Delete Datasource", readOnlyHint: false, destructiveHint: true, openWorldHint: true }, ({ uid }) => runTool(runtime5, exports_Effect.gen(function* () {
+  }, {
+    title: "Delete Datasource",
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: true,
+    openWorldHint: true
+  }, ({ uid }) => runTool(runtime5, exports_Effect.gen(function* () {
     const client = yield* GrafanaClient;
     yield* client.deleteDatasource(uid);
     return { ok: true };
@@ -44766,20 +44840,38 @@ var registerDatasourceTools = (server, runtime5) => {
 
 // src/mcp/tools/folders.ts
 var registerFolderTools = (server, runtime5) => {
-  server.tool("list_folders", "List all Grafana folders. Returns uid, title, and url.", {}, { title: "List Folders", readOnlyHint: true, openWorldHint: true }, () => runTool(runtime5, exports_Effect.gen(function* () {
+  server.tool("list_folders", "List all Grafana folders. Returns uid, title, and url.", {}, {
+    title: "List Folders",
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  }, () => runTool(runtime5, exports_Effect.gen(function* () {
     const client = yield* GrafanaClient;
     return yield* client.listFolders();
   })));
   server.tool("create_folder", "Create a new Grafana folder for organising dashboards.", {
     title: exports_external.string().describe("Folder title"),
     uid: exports_external.string().optional().describe("Optional custom UID for the folder")
-  }, { title: "Create Folder", readOnlyHint: false, destructiveHint: false, openWorldHint: true }, ({ title, uid }) => runTool(runtime5, exports_Effect.gen(function* () {
+  }, {
+    title: "Create Folder",
+    readOnlyHint: false,
+    destructiveHint: false,
+    idempotentHint: false,
+    openWorldHint: true
+  }, ({ title, uid }) => runTool(runtime5, exports_Effect.gen(function* () {
     const client = yield* GrafanaClient;
     return yield* client.createFolder(title, uid);
   })));
   server.tool("delete_folder", "Delete a Grafana folder by UID. Deleting a folder also deletes all dashboards within it.", {
     uid: exports_external.string().describe("Folder UID")
-  }, { title: "Delete Folder", readOnlyHint: false, destructiveHint: true, openWorldHint: true }, ({ uid }) => runTool(runtime5, exports_Effect.gen(function* () {
+  }, {
+    title: "Delete Folder",
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: true,
+    openWorldHint: true
+  }, ({ uid }) => runTool(runtime5, exports_Effect.gen(function* () {
     const client = yield* GrafanaClient;
     yield* client.deleteFolder(uid);
     return { ok: true };
@@ -44788,7 +44880,13 @@ var registerFolderTools = (server, runtime5) => {
 
 // src/mcp/tools/health.ts
 var registerHealthTools = (server, runtime5) => {
-  server.tool("health_check", "Check the health of the Grafana instance. Returns version, database status, and commit hash.", {}, { title: "Health Check", readOnlyHint: true, openWorldHint: true }, () => runTool(runtime5, exports_Effect.gen(function* () {
+  server.tool("health_check", "Check the health of the Grafana instance. Returns version, database status, and commit hash.", {}, {
+    title: "Health Check",
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  }, () => runTool(runtime5, exports_Effect.gen(function* () {
     const client = yield* GrafanaClient;
     return yield* client.healthCheck();
   })));

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@daanrongen/grafana-mcp",
-  "version": "1.1.0",
-  "description": "MCP server for Grafana \u2014 manage dashboards, datasources, alerts, folders, and annotations over stdio",
+  "version": "1.2.1",
+  "description": "MCP server for Grafana — manage dashboards, datasources, alerts, folders, and annotations over stdio",
   "type": "module",
   "bin": {
     "grafana-mcp": "./dist/main.js"