next-finance-mcp 0.5.0 → 0.5.2

package/dist/client.d.ts

@@ -29,6 +29,7 @@ export interface FiltroContas {
 export interface ResultadoContas {
     contas: Record<string, unknown>[];
     paginacao: PaginaMeta;
+    _fonte?: string;
 }
 export declare function listarContas(filtro?: FiltroContas): Promise<ResultadoContas>;
 export interface FiltroPlanoDeContas {
@@ -40,6 +41,12 @@ export declare function listarPlanoDeContas(filtro?: FiltroPlanoDeContas): Promi
     planos: Record<string, unknown>[];
     paginacao: PaginaMeta;
 }>;
+export declare function listarCentrosDeCusto(busca?: string): Promise<{
+    centros: Record<string, unknown>[];
+}>;
+export declare function listarTiposConta(): Promise<{
+    tipos: Record<string, unknown>[];
+}>;
 export interface FiltroLancamentos {
     idConta?: string;
     dataInicio?: string;

package/dist/client.js

@@ -5,7 +5,8 @@
 import * as fs from "fs";
 import * as path from "path";
 import * as os from "os";
-const WEB_BASE = "https://finance.net.br";
+const WEB_BASE = "https://finance.net.br"; // login e seleção de carteira (MVC)
+const API_BASE = "https://api.finance.net.br"; // API REST (mesmo cookie de sessão)
 const SESSION_DIR = path.join(os.homedir(), ".next-finance-mcp");
 const SESSION_FILE = path.join(SESSION_DIR, "session.json");
 export function saveSession() {
@@ -91,9 +92,9 @@ async function webPost(path, body, contentType, followRedirect = true) {
     storeCookies(res.headers.getSetCookie?.() ?? [], "finance.net.br");
     return { status: res.status, text: await res.text(), location: res.headers.get("location") ?? undefined };
 }
-/** GET para a API REST (/api/*) — mesmo cookie de sessão */
+/** GET para a API REST — usa api.finance.net.br com o mesmo cookie de sessão */
 async function apiGet(path) {
-    const res = await fetch(`${WEB_BASE}${path}`, {
+    const res = await fetch(`${API_BASE}${path}`, {
         headers: { ...BASE_HEADERS, Cookie: getCookieHeader("finance.net.br"), Accept: "application/json" },
     });
     storeCookies(res.headers.getSetCookie?.() ?? [], "finance.net.br");
@@ -101,9 +102,9 @@ async function apiGet(path) {
         throw new Error(`API GET ${path}: ${res.status}`);
     return res.json();
 }
-/** POST JSON para a API REST (/api/*) — mesmo cookie de sessão */
+/** POST JSON para a API REST — usa api.finance.net.br com o mesmo cookie de sessão */
 async function apiPost(path, body) {
-    const res = await fetch(`${WEB_BASE}${path}`, {
+    const res = await fetch(`${API_BASE}${path}`, {
         method: "POST",
         headers: { ...BASE_HEADERS, Cookie: getCookieHeader("finance.net.br"),
             "Content-Type": "application/json", Accept: "application/json" },
@@ -194,27 +195,73 @@ export async function selecionarCarteira(idCarteira) {
     }
     return { sucesso: ok, mensagem: ok ? `Carteira ${idCarteira} selecionada.` : `Falha ao selecionar carteira (${resp.status}).` };
 }
+/** Campos essenciais de conta — descarta metadados pesados */
+function slimConta(c) {
+    if (!c || typeof c !== "object")
+        return {};
+    const o = c;
+    const KEEP = new Set(["Id", "Nome", "Descricao", "NomeConta", "IdTipoConta", "NomeTipoConta",
+        "Tipo", "Ativo", "Status", "Saldo", "Banco", "Agencia", "Numero", "Moeda"]);
+    const slim = {};
+    for (const [k, v] of Object.entries(o)) {
+        if (KEEP.has(k) && v !== null && typeof v !== "object")
+            slim[k] = v;
+    }
+    // Fallback: todos os primitivos se lista ficou vazia
+    if (Object.keys(slim).length === 0) {
+        for (const [k, v] of Object.entries(o)) {
+            if (v !== null && typeof v !== "object")
+                slim[k] = v;
+        }
+    }
+    return slim;
+}
+/** Tenta endpoints em ordem até encontrar um que responda com dados */
+async function fetchContas() {
+    // Todos os endpoints REST agora apontam para api.finance.net.br via apiGet()
+    const tentativas = [
+        { path: "/api/Conta/ListarContasDeFormaLeve", tipo: "json" },
+        { path: "/api/Conta", tipo: "json" },
+        { path: "/api/Conta/TodasAsContas", tipo: "json" },
+        { path: "/ContaAjax/ListarTodos", tipo: "legacy" }, // fallback MVC legado
+    ];
+    for (const { path, tipo } of tentativas) {
+        try {
+            let raw;
+            if (tipo === "json") {
+                raw = await apiGet(path);
+            }
+            else {
+                const r = await webGet(path);
+                if (r.status !== 200)
+                    continue;
+                raw = JSON.parse(r.text);
+            }
+            const arr = Array.isArray(raw)
+                ? raw
+                : (Object.values(raw).find(v => Array.isArray(v)) ?? []);
+            if (arr.length > 0)
+                return { contas: arr, fonte: path };
+        }
+        catch { /* tenta o próximo */ }
+    }
+    throw new Error("Nenhum endpoint de contas respondeu com dados. Verifique se a carteira está selecionada.");
+}
 export async function listarContas(filtro = {}) {
-    const raw = await apiGet("/api/Conta/ListarContasDeFormaLeve");
-    let contas = Array.isArray(raw) ? raw : Object.values(raw).find(v => Array.isArray(v)) ?? [];
-    // Filtro por nome
+    const { contas: raw, fonte } = await fetchContas();
+    let contas = raw.map(slimConta);
+    // Filtro por nome (busca em Nome, Descricao, NomeConta)
     if (filtro.busca?.trim()) {
         const termo = filtro.busca.trim().toLowerCase();
-        contas = contas.filter(c => {
-            const obj = c;
-            return [obj["Nome"], obj["Descricao"], obj["NomeConta"]]
-                .some(v => typeof v === "string" && v.toLowerCase().includes(termo));
-        });
+        contas = contas.filter(c => [c["Nome"], c["Descricao"], c["NomeConta"]]
+            .some(v => typeof v === "string" && v.toLowerCase().includes(termo)));
     }
-    // Filtro por IdTipoConta (campo correto conforme estrutura da API)
+    // Filtro por IdTipoConta
     if (filtro.idTipoConta && filtro.idTipoConta.length > 0) {
         const tipos = new Set(filtro.idTipoConta.map(String));
-        contas = contas.filter(c => {
-            const obj = c;
-            return tipos.has(String(obj["IdTipoConta"]));
-        });
+        contas = contas.filter(c => tipos.has(String(c["IdTipoConta"])));
     }
-    // Paginação client-side (o endpoint leve retorna tudo de uma vez)
+    // Paginação client-side
     const pagina = Math.max(1, filtro.pagina ?? 1);
     const limite = Math.min(200, Math.max(1, filtro.limite ?? 50));
     const total = contas.length;
@@ -222,6 +269,7 @@ export async function listarContas(filtro = {}) {
     return {
         contas: contas.slice(inicio, inicio + limite),
         paginacao: { pagina, limite, total, paginas: Math.ceil(total / limite), tem_mais: inicio + limite < total },
+        _fonte: fonte,
     };
 }
 export async function listarPlanoDeContas(filtro = {}) {
@@ -244,6 +292,25 @@ export async function listarPlanoDeContas(filtro = {}) {
         paginacao: { pagina, limite, total, paginas: Math.ceil(total / limite), tem_mais: inicio + limite < total },
     };
 }
+// ── Centro de Custos ─────────────────────────────────────────────────────────
+export async function listarCentrosDeCusto(busca) {
+    const raw = await apiGet("/api/CentroDeCustos");
+    let centros = Array.isArray(raw) ? raw : Object.values(raw).find(v => Array.isArray(v)) ?? [];
+    if (busca?.trim()) {
+        const t = busca.trim().toLowerCase();
+        centros = centros.filter(c => {
+            const o = c;
+            return [o["Nome"], o["Descricao"]].some(v => typeof v === "string" && v.toLowerCase().includes(t));
+        });
+    }
+    return { centros: centros };
+}
+// ── Tipos de Conta ────────────────────────────────────────────────────────────
+export async function listarTiposConta() {
+    const raw = await apiGet("/api/TipoConta");
+    const tipos = Array.isArray(raw) ? raw : Object.values(raw).find(v => Array.isArray(v)) ?? [];
+    return { tipos: tipos };
+}
 function slimLancamento(l) {
     return {
         data: String(l["Data"] ?? "").slice(0, 10),
@@ -266,17 +333,37 @@ export async function buscarLancamentos(opts) {
     const dataFim = opts.dataFim ?? today.toISOString().slice(0, 10);
     const pagina = Math.max(1, opts.pagina ?? 1);
     const limite = Math.min(200, Math.max(1, opts.limite ?? 50));
-    // Chama a API REST com paginação server-side nativa
-    const body = {
-        IntervaloDeDatas: { DataInicio: dataInicio, DataFim: dataFim },
-        Pagina: pagina - 1, // API é 0-indexed
-        RegistrosPorPagina: limite,
-        ListarOrdenadoPelaDataDeModificacao: false,
-    };
-    if (opts.idConta)
-        body["IdConta"] = opts.idConta;
-    const resp = await apiPost("/api/Lancamento/Filtrar", body);
-    let lancamentos = resp["Lancamentos"] ?? [];
+    let lancamentos;
+    // Tenta API REST primeiro; cai no endpoint legado se falhar
+    try {
+        const body = {
+            IntervaloDeDatas: { DataInicio: dataInicio, DataFim: dataFim },
+            Pagina: pagina - 1, // API é 0-indexed
+            RegistrosPorPagina: limite,
+            ListarOrdenadoPelaDataDeModificacao: false,
+        };
+        if (opts.idConta)
+            body["IdConta"] = opts.idConta;
+        const resp = await apiPost("/api/Lancamento/Filtrar", body);
+        lancamentos = resp["Lancamentos"] ?? [];
+    }
+    catch {
+        // Fallback: endpoint legado (form-urlencoded) — requer IdConta
+        if (!opts.idConta)
+            throw new Error("A API REST de lançamentos não está disponível e o endpoint legado requer id_conta. " +
+                "Informe um id_conta e tente novamente.");
+        const params = new URLSearchParams();
+        params.set("filtro[IdConta]", opts.idConta);
+        params.set("filtro[IntervaloDeDatas][DataInicio]", dataInicio);
+        params.set("filtro[IntervaloDeDatas][DataFim]", dataFim);
+        params.set("filtro[ListarOrdenadoPelaDataDeModificacao]", "false");
+        const r = await webPost("/LancamentoAjax/Filtrar", params.toString(), "application/x-www-form-urlencoded");
+        if (r.status !== 200)
+            throw new Error(`Erro ${r.status} ao buscar lançamentos.`);
+        const raw = JSON.parse(r.text);
+        lancamentos = Array.isArray(raw) ? raw
+            : (Object.values(raw).find(v => Array.isArray(v)) ?? []);
+    }
     // Filtros client-side (a API não filtra por plano/centro/tipo)
     const excluirTransf = opts.excluirTransferencias !== false; // default: true
     if (excluirTransf)

package/dist/index.js

@@ -56,6 +56,21 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 },
             },
         },
+        {
+            name: "listar_tipos_conta",
+            description: "Lista os tipos de conta disponíveis (corrente, poupança, cartão, investimento etc.) com seus IDs. Use para descobrir os IDs antes de filtrar listar_contas por tipo.",
+            inputSchema: { type: "object", properties: {} },
+        },
+        {
+            name: "listar_centros_de_custo",
+            description: "Lista os centros de custo da carteira. Use para descobrir nomes exatos antes de filtrar lançamentos por centro de custo.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    busca: { type: "string", description: "Filtra pelo nome do centro de custo" },
+                },
+            },
+        },
         {
             name: "listar_plano_de_contas",
             description: "Lista o plano de contas da carteira (categorias de receita e despesa). " +
@@ -157,6 +172,21 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
                     limite: args["limite"],
                 }));
             }
+            case "listar_tipos_conta": {
+                const authErr = requireAuth();
+                if (authErr)
+                    return authErr;
+                return ok(await client.listarTiposConta());
+            }
+            case "listar_centros_de_custo": {
+                const authErr = requireAuth();
+                if (authErr)
+                    return authErr;
+                const walErr = requireWallet();
+                if (walErr)
+                    return walErr;
+                return ok(await client.listarCentrosDeCusto(args["busca"]));
+            }
             case "listar_plano_de_contas": {
                 const authErr = requireAuth();
                 if (authErr)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "next-finance-mcp",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "mcpName": "io.github.paivapiovesan/next-finance",
   "description": "MCP Server para o NEXT Finance (finance.net.br) — login via browser, listagem de carteiras, contas e lançamentos",
   "type": "module",