innov-mcp-tasks 1.5.0 → 1.6.0

package/README.md

@@ -82,6 +82,14 @@ Na raiz do repo existe [`.cursor/mcp.json`](../.cursor/mcp.json) com **dois** se
 - `agents_list` — agentes utilizáveis pelo token (`GET /api/v1/ai-agents?scope=usable`); opcional `scope=manageable` para gestão
 - `agent_chat` — envia `message` a um agente (`POST /api/v1/ai-agents/{ulid}/chat`); devolve `response` e `citations`; opcional `conversation_ulid`, `project_id`, `notebook_id`
 
+### Infraestrutura / servidores (SPEC-022)
+
+- `servers_dashboard` — resumo online/offline, alertas e aplicações (`GET /server-monitoring/dashboard`)
+- `servers_list` — lista servidores com métricas; filtros opcionais `status`, `search`
+- `server_get` — detalhe por `server_ulid` (métricas + aplicações com tipo/versão)
+- `server_alerts` — alertas ativos de CPU, RAM, disco e aplicações
+- `server_applications_search` — busca apps (`search`, `type`, `server_ulid`, `env_production`, `debug_enabled`, paginação)
+
 ## Publicar no npm (mantenedor)
 
 1. Define o **nome** em `package.json` (`innov-mcp-tasks` ou `@scope/innov-mcp-tasks` se o nome simples estiver tomado).

package/index.mjs

@@ -7,6 +7,13 @@ import { z } from 'zod';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { agentChat, agentsList } from './lib/agents.mjs';
+import {
+  serverAlerts,
+  serverApplicationsSearch,
+  serverGet,
+  serversDashboard,
+  serversList,
+} from './lib/serverMonitoring.mjs';
 
 const base = (process.env.INNOV_API_BASE_URL || '').replace(/\/$/, '');
 const token = (process.env.INNOV_API_TOKEN || '').trim();
@@ -862,5 +869,103 @@ server.registerTool(
   },
 );
 
+server.registerTool(
+  'servers_dashboard',
+  {
+    description:
+      'Resumo do monitoramento de servidores (GET /server-monitoring/dashboard): online/offline, alertas e aplicações.',
+    inputSchema: {},
+  },
+  async () => {
+    try {
+      const data = await serversDashboard(apiFetch);
+      return jsonText(data);
+    } catch (e) {
+      return jsonError(e instanceof Error ? e.message : String(e));
+    }
+  },
+);
+
+server.registerTool(
+  'servers_list',
+  {
+    description:
+      'Lista servidores monitorados com métricas recentes (GET /server-monitoring/servers).',
+    inputSchema: {
+      status: z.enum(['active', 'inactive']).optional(),
+      search: z.string().optional().describe('Hostname, IP ou descrição'),
+    },
+  },
+  async (args) => {
+    try {
+      const data = await serversList(apiFetch, args);
+      return jsonText(data);
+    } catch (e) {
+      return jsonError(e instanceof Error ? e.message : String(e));
+    }
+  },
+);
+
+server.registerTool(
+  'server_get',
+  {
+    description:
+      'Detalhe de um servidor: métricas, histórico e aplicações detectadas (GET /server-monitoring/servers/{ulid}).',
+    inputSchema: {
+      server_ulid: z.string().min(1).describe('ULID do servidor'),
+    },
+  },
+  async (args) => {
+    try {
+      const data = await serverGet(apiFetch, args);
+      return jsonText(data);
+    } catch (e) {
+      return jsonError(e instanceof Error ? e.message : String(e));
+    }
+  },
+);
+
+server.registerTool(
+  'server_alerts',
+  {
+    description:
+      'Alertas ativos de infraestrutura: CPU, RAM, disco e aplicações (GET /server-monitoring/alerts).',
+    inputSchema: {},
+  },
+  async () => {
+    try {
+      const data = await serverAlerts(apiFetch);
+      return jsonText(data);
+    } catch (e) {
+      return jsonError(e instanceof Error ? e.message : String(e));
+    }
+  },
+);
+
+server.registerTool(
+  'server_applications_search',
+  {
+    description:
+      'Busca aplicações nos servidores: stack (laravel, vuejs…), versão, ambiente (GET /server-monitoring/applications/search).',
+    inputSchema: {
+      search: z.string().optional(),
+      type: z.string().optional().describe('laravel, vuejs, symfony, wordpress, etc.'),
+      server_ulid: z.string().optional(),
+      env_production: z.boolean().optional(),
+      debug_enabled: z.boolean().optional(),
+      limit: z.number().int().min(1).max(50).optional(),
+      page: z.number().int().min(1).optional(),
+    },
+  },
+  async (args) => {
+    try {
+      const data = await serverApplicationsSearch(apiFetch, args);
+      return jsonText(data);
+    } catch (e) {
+      return jsonError(e instanceof Error ? e.message : String(e));
+    }
+  },
+);
+
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/lib/serverMonitoring.mjs

@@ -0,0 +1,98 @@
+/** Helpers e handlers para ferramentas de monitoramento de servidores (SPEC-022). */
+
+/**
+ * @param {Record<string, string | number | boolean | undefined | null>} [params]
+ */
+export function serverMonitoringQueryString(params = {}) {
+  const search = new URLSearchParams();
+  for (const [key, value] of Object.entries(params)) {
+    if (value === undefined || value === null || value === '') {
+      continue;
+    }
+    search.set(key, String(value));
+  }
+  const qs = search.toString();
+  return qs ? `?${qs}` : '';
+}
+
+export function serversDashboardPath() {
+  return '/api/v1/server-monitoring/dashboard';
+}
+
+/**
+ * @param {{ status?: string, search?: string }} [args]
+ */
+export function serversListPath(args = {}) {
+  return `/api/v1/server-monitoring/servers${serverMonitoringQueryString({
+    status: args.status,
+    search: args.search,
+  })}`;
+}
+
+/**
+ * @param {string} serverUlid
+ */
+export function serverGetPath(serverUlid) {
+  const trimmed = String(serverUlid ?? '').trim();
+  if (!trimmed) {
+    throw new Error('server_ulid é obrigatório');
+  }
+  return `/api/v1/server-monitoring/servers/${encodeURIComponent(trimmed)}`;
+}
+
+export function serverAlertsPath() {
+  return '/api/v1/server-monitoring/alerts';
+}
+
+/**
+ * @param {Record<string, string | number | boolean | undefined | null>} [args]
+ */
+export function serverApplicationsSearchPath(args = {}) {
+  const { limit, page, ...rest } = args;
+  return `/api/v1/server-monitoring/applications/search${serverMonitoringQueryString({
+    ...rest,
+    per_page: limit ?? rest.per_page,
+    page,
+  })}`;
+}
+
+/**
+ * @param {(path: string, init?: RequestInit) => Promise<unknown>} apiFetch
+ */
+export async function serversDashboard(apiFetch) {
+  return apiFetch(serversDashboardPath());
+}
+
+/**
+ * @param {(path: string, init?: RequestInit) => Promise<unknown>} apiFetch
+ * @param {{ status?: string, search?: string }} [args]
+ */
+export async function serversList(apiFetch, args = {}) {
+  const data = await apiFetch(serversListPath(args));
+  return data?.data ?? data;
+}
+
+/**
+ * @param {(path: string, init?: RequestInit) => Promise<unknown>} apiFetch
+ * @param {{ server_ulid: string }} args
+ */
+export async function serverGet(apiFetch, args) {
+  const data = await apiFetch(serverGetPath(args.server_ulid));
+  return data?.data ?? data;
+}
+
+/**
+ * @param {(path: string, init?: RequestInit) => Promise<unknown>} apiFetch
+ */
+export async function serverAlerts(apiFetch) {
+  const data = await apiFetch(serverAlertsPath());
+  return data?.data ?? data;
+}
+
+/**
+ * @param {(path: string, init?: RequestInit) => Promise<unknown>} apiFetch
+ * @param {Record<string, string | number | boolean | undefined | null>} [args]
+ */
+export async function serverApplicationsSearch(apiFetch, args = {}) {
+  return apiFetch(serverApplicationsSearchPath(args));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "innov-mcp-tasks",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "MCP stdio — tarefas, anotações e agentes de IA Innov (INNOV_API_BASE_URL + token Sanctum)",
   "type": "module",
   "main": "index.mjs",