innov-mcp-tasks 1.0.2 → 1.2.0

package/README.md

@@ -50,11 +50,30 @@ Na raiz do repo existe [`.cursor/mcp.json`](../.cursor/mcp.json) com **dois** se
 
 ## Ferramentas
 
+### Tarefas e projetos
+
 - `tasks_list` — opcional `project_id`
 - `my_tasks` — tarefas do utilizador do token (endpoint “minhas” da API)
+- `projects_list` — lista projetos visíveis (`GET /api/v1/projects`)
 - `project_create` — cria projeto (`POST /api/v1/projects`)
 - `task_get`, `task_create`, `task_update_status`, `task_assign`, `task_assign_to_me`
 
+### Anotações / documentação
+
+- `notes_list` — lista com filtros opcionais (`project_id`, `note_type`, `notebook_id`)
+- `notes_personal` — anotações pessoais
+- `notes_by_project` — anotações de um projeto (inclui criador em `user`)
+- `note_get`, `note_create`, `note_update`
+- `note_delete` — soft delete (lixeira)
+- `notes_trashed`, `note_restore`
+- `annotations_search` — busca em cadernos, notas e fontes (`q` ≥ 2 caracteres)
+
+### Cadernos (notebooks)
+
+- `notebooks_list` — lista com filtro opcional `project_id`
+- `notebook_get`, `notebook_create`, `notebook_update`, `notebook_delete`
+- `notebook_documentation` — notas + fontes do caderno
+
 ## 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

@@ -105,6 +105,23 @@ server.registerTool(
   },
 );
 
+server.registerTool(
+  'projects_list',
+  {
+    description:
+      'Lista projetos visíveis ao utilizador do token (GET /projects). Inclui creator, tasks, team e allowedUsers.',
+    inputSchema: {},
+  },
+  async () => {
+    try {
+      const data = await apiFetch('/api/v1/projects');
+      return jsonText(data);
+    } catch (e) {
+      return jsonError(e instanceof Error ? e.message : String(e));
+    }
+  },
+);
+
 server.registerTool(
   'project_create',
   {
@@ -248,5 +265,369 @@ server.registerTool(
   },
 );
 
+function notesQueryString(filters) {
+  const params = new URLSearchParams();
+  if (filters.project_id != null) {
+    params.set('project_id', String(filters.project_id));
+  }
+  if (filters.note_type != null) {
+    params.set('note_type', filters.note_type);
+  }
+  if (filters.notebook_id != null) {
+    params.set('notebook_id', String(filters.notebook_id));
+  }
+  const qs = params.toString();
+  return qs ? `?${qs}` : '';
+}
+
+server.registerTool(
+  'notes_list',
+  {
+    description:
+      'Lista anotações do utilizador do token (GET /notes). Filtros opcionais: project_id, note_type (personal|project), notebook_id.',
+    inputSchema: {
+      project_id: z.number().int().positive().optional(),
+      note_type: z.enum(['personal', 'project']).optional(),
+      notebook_id: z.number().int().positive().optional(),
+    },
+  },
+  async (args) => {
+    try {
+      const data = await apiFetch(`/api/v1/notes${notesQueryString(args)}`);
+      return jsonText(data);
+    } catch (e) {
+      return jsonError(e instanceof Error ? e.message : String(e));
+    }
+  },
+);
+
+server.registerTool(
+  'notes_personal',
+  {
+    description: 'Anotações pessoais do utilizador do token (GET /notes/personal).',
+    inputSchema: {},
+  },
+  async () => {
+    try {
+      const data = await apiFetch('/api/v1/notes/personal');
+      return jsonText(data);
+    } catch (e) {
+      return jsonError(e instanceof Error ? e.message : String(e));
+    }
+  },
+);
+
+server.registerTool(
+  'notes_by_project',
+  {
+    description:
+      'Anotações de um projeto visível (GET /notes/project/{project_id}). Inclui user (criador).',
+    inputSchema: { project_id: z.number().int().positive() },
+  },
+  async (args) => {
+    try {
+      const data = await apiFetch(
+        `/api/v1/notes/project/${args.project_id}`,
+      );
+      return jsonText(data);
+    } catch (e) {
+      return jsonError(e instanceof Error ? e.message : String(e));
+    }
+  },
+);
+
+server.registerTool(
+  'note_get',
+  {
+    description: 'Obtém uma anotação por id (GET /notes/{id}). Só o autor.',
+    inputSchema: { note_id: z.number().int().positive() },
+  },
+  async (args) => {
+    try {
+      const data = await apiFetch(`/api/v1/notes/${args.note_id}`);
+      return jsonText(data);
+    } catch (e) {
+      return jsonError(e instanceof Error ? e.message : String(e));
+    }
+  },
+);
+
+server.registerTool(
+  'note_create',
+  {
+    description:
+      'Cria anotação (POST /notes). Pessoal sem project_id; de projeto com note_type project + project_id; opcional notebook_id.',
+    inputSchema: {
+      content: z.string().min(1),
+      title: z.string().max(255).optional(),
+      note_type: z.enum(['personal', 'project']).optional(),
+      project_id: z.number().int().positive().optional(),
+      notebook_id: z.number().int().positive().optional(),
+    },
+  },
+  async (args) => {
+    try {
+      const body = {
+        content: args.content,
+        title: args.title ?? null,
+        note_type: args.note_type ?? null,
+        project_id: args.project_id ?? null,
+        notebook_id: args.notebook_id ?? null,
+      };
+      const data = await apiFetch('/api/v1/notes', {
+        method: 'POST',
+        body: JSON.stringify(body),
+      });
+      return jsonText(data);
+    } catch (e) {
+      return jsonError(e instanceof Error ? e.message : String(e));
+    }
+  },
+);
+
+server.registerTool(
+  'note_update',
+  {
+    description: 'Atualiza anotação (PUT /notes/{id}). Só o autor.',
+    inputSchema: {
+      note_id: z.number().int().positive(),
+      title: z.string().max(255).optional(),
+      content: z.string().optional(),
+      note_type: z.enum(['personal', 'project']).optional(),
+      project_id: z.number().int().positive().optional(),
+      notebook_id: z.number().int().positive().optional(),
+    },
+  },
+  async (args) => {
+    try {
+      const { note_id, ...fields } = args;
+      const body = Object.fromEntries(
+        Object.entries(fields).filter(([, v]) => v !== undefined),
+      );
+      const data = await apiFetch(`/api/v1/notes/${note_id}`, {
+        method: 'PUT',
+        body: JSON.stringify(body),
+      });
+      return jsonText(data);
+    } catch (e) {
+      return jsonError(e instanceof Error ? e.message : String(e));
+    }
+  },
+);
+
+server.registerTool(
+  'note_delete',
+  {
+    description:
+      'Remove anotação para a lixeira — soft delete (DELETE /notes/{id}). Só o autor.',
+    inputSchema: { note_id: z.number().int().positive() },
+  },
+  async (args) => {
+    try {
+      const data = await apiFetch(`/api/v1/notes/${args.note_id}`, {
+        method: 'DELETE',
+      });
+      return jsonText(data);
+    } catch (e) {
+      return jsonError(e instanceof Error ? e.message : String(e));
+    }
+  },
+);
+
+server.registerTool(
+  'notes_trashed',
+  {
+    description:
+      'Lista anotações na lixeira do utilizador (GET /notes/trashed). Filtros opcionais como notes_list.',
+    inputSchema: {
+      project_id: z.number().int().positive().optional(),
+      note_type: z.enum(['personal', 'project']).optional(),
+      notebook_id: z.number().int().positive().optional(),
+    },
+  },
+  async (args) => {
+    try {
+      const data = await apiFetch(
+        `/api/v1/notes/trashed${notesQueryString(args)}`,
+      );
+      return jsonText(data);
+    } catch (e) {
+      return jsonError(e instanceof Error ? e.message : String(e));
+    }
+  },
+);
+
+server.registerTool(
+  'note_restore',
+  {
+    description:
+      'Restaura anotação da lixeira (POST /notes/{id}/restore). Só o autor.',
+    inputSchema: { note_id: z.number().int().positive() },
+  },
+  async (args) => {
+    try {
+      const data = await apiFetch(
+        `/api/v1/notes/${args.note_id}/restore`,
+        { method: 'POST' },
+      );
+      return jsonText(data);
+    } catch (e) {
+      return jsonError(e instanceof Error ? e.message : String(e));
+    }
+  },
+);
+
+server.registerTool(
+  'annotations_search',
+  {
+    description:
+      'Busca em cadernos, anotações e fontes (GET /annotations/search?q=). Mínimo 2 caracteres.',
+    inputSchema: { q: z.string().min(2) },
+  },
+  async (args) => {
+    try {
+      const data = await apiFetch(
+        `/api/v1/annotations/search?q=${encodeURIComponent(args.q)}`,
+      );
+      return jsonText(data);
+    } catch (e) {
+      return jsonError(e instanceof Error ? e.message : String(e));
+    }
+  },
+);
+
+server.registerTool(
+  'notebooks_list',
+  {
+    description:
+      'Lista cadernos visíveis ao utilizador do token (GET /notebooks). Filtro opcional project_id.',
+    inputSchema: {
+      project_id: z.number().int().positive().optional(),
+    },
+  },
+  async (args) => {
+    try {
+      const qs =
+        args.project_id != null
+          ? `?project_id=${encodeURIComponent(String(args.project_id))}`
+          : '';
+      const data = await apiFetch(`/api/v1/notebooks${qs}`);
+      return jsonText(data);
+    } catch (e) {
+      return jsonError(e instanceof Error ? e.message : String(e));
+    }
+  },
+);
+
+server.registerTool(
+  'notebook_get',
+  {
+    description: 'Obtém um caderno por id (GET /notebooks/{id}).',
+    inputSchema: { notebook_id: z.number().int().positive() },
+  },
+  async (args) => {
+    try {
+      const data = await apiFetch(`/api/v1/notebooks/${args.notebook_id}`);
+      return jsonText(data);
+    } catch (e) {
+      return jsonError(e instanceof Error ? e.message : String(e));
+    }
+  },
+);
+
+server.registerTool(
+  'notebook_create',
+  {
+    description:
+      'Cria caderno (POST /notebooks). Pessoal sem project_id; de projeto com project_id. name obrigatório.',
+    inputSchema: {
+      name: z.string().min(1).max(255),
+      description: z.string().optional(),
+      project_id: z.number().int().positive().optional(),
+    },
+  },
+  async (args) => {
+    try {
+      const body = {
+        name: args.name,
+        description: args.description ?? null,
+        project_id: args.project_id ?? null,
+      };
+      const data = await apiFetch('/api/v1/notebooks', {
+        method: 'POST',
+        body: JSON.stringify(body),
+      });
+      return jsonText(data);
+    } catch (e) {
+      return jsonError(e instanceof Error ? e.message : String(e));
+    }
+  },
+);
+
+server.registerTool(
+  'notebook_update',
+  {
+    description: 'Atualiza caderno (PATCH /notebooks/{id}). Só cadernos do utilizador.',
+    inputSchema: {
+      notebook_id: z.number().int().positive(),
+      name: z.string().min(1).max(255).optional(),
+      description: z.string().optional(),
+      project_id: z.number().int().positive().optional(),
+    },
+  },
+  async (args) => {
+    try {
+      const { notebook_id, ...fields } = args;
+      const body = Object.fromEntries(
+        Object.entries(fields).filter(([, v]) => v !== undefined),
+      );
+      const data = await apiFetch(`/api/v1/notebooks/${notebook_id}`, {
+        method: 'PATCH',
+        body: JSON.stringify(body),
+      });
+      return jsonText(data);
+    } catch (e) {
+      return jsonError(e instanceof Error ? e.message : String(e));
+    }
+  },
+);
+
+server.registerTool(
+  'notebook_delete',
+  {
+    description: 'Apaga caderno (DELETE /notebooks/{id}). Só cadernos do utilizador.',
+    inputSchema: { notebook_id: z.number().int().positive() },
+  },
+  async (args) => {
+    try {
+      const data = await apiFetch(`/api/v1/notebooks/${args.notebook_id}`, {
+        method: 'DELETE',
+      });
+      return jsonText(data);
+    } catch (e) {
+      return jsonError(e instanceof Error ? e.message : String(e));
+    }
+  },
+);
+
+server.registerTool(
+  'notebook_documentation',
+  {
+    description:
+      'Documentação agregada do caderno: notas do utilizador + fontes (GET /notebooks/{id}/documentation).',
+    inputSchema: { notebook_id: z.number().int().positive() },
+  },
+  async (args) => {
+    try {
+      const data = await apiFetch(
+        `/api/v1/notebooks/${args.notebook_id}/documentation`,
+      );
+      return jsonText(data);
+    } catch (e) {
+      return jsonError(e instanceof Error ? e.message : String(e));
+    }
+  },
+);
+
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "innov-mcp-tasks",
-  "version": "1.0.2",
-  "description": "MCP stdio — ferramentas de tarefas Innov (API a configurar via INNOV_API_BASE_URL + token Sanctum)",
+  "version": "1.2.0",
+  "description": "MCP stdio — tarefas e anotações Innov (INNOV_API_BASE_URL + token Sanctum)",
   "type": "module",
   "main": "index.mjs",
   "bin": {
@@ -26,6 +26,8 @@
     "mcp",
     "modelcontextprotocol",
     "tasks",
+    "notes",
+    "annotations",
     "innov"
   ],
   "author": "",