next-finance-mcp 0.3.0

package/README.md

@@ -0,0 +1,59 @@
+# next-finance-mcp
+
+MCP Server para o **[NEXT Finance](https://finance.net.br)** — conecta o Claude ao seu ERP financeiro com login seguro via browser.
+
+## Funcionalidades
+
+- 🔐 **Login via browser** — credenciais nunca passam pelo chat
+- 💾 **Sessão persistente** — não precisa logar toda vez (válida por 3 dias)
+- 💼 **Listar carteiras** — veja todas as suas carteiras disponíveis
+- 🏦 **Listar contas** — contas correntes, investimentos, cartões, etc.
+- 📊 **Buscar lançamentos** — transações com filtro por data
+
+## Instalação no Claude Desktop
+
+Adicione ao seu `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "next-finance": {
+      "command": "npx",
+      "args": ["-y", "next-finance-mcp"]
+    }
+  }
+}
+```
+
+**Localização do arquivo:**
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+Reinicie o Claude Desktop após salvar.
+
+## Como usar
+
+1. Peça ao Claude para fazer login: *"Faça login no NEXT Finance"*
+2. O browser abrirá automaticamente com o formulário de login
+3. Preencha e-mail e senha — as credenciais ficam apenas no browser
+4. De volta ao Claude, liste as carteiras e comece a usar
+
+## Ferramentas disponíveis
+
+| Ferramenta | Descrição |
+|---|---|
+| `login` | Abre o browser para login seguro (ou restaura sessão salva) |
+| `logout` | Encerra a sessão |
+| `listar_carteiras` | Lista todas as carteiras do usuário |
+| `selecionar_carteira` | Seleciona uma carteira pelo ID |
+| `listar_contas` | Lista as contas da carteira selecionada |
+| `buscar_lancamentos` | Busca lançamentos de uma conta por período |
+
+## Requisitos
+
+- Node.js 18+
+- Conta no [NEXT Finance](https://finance.net.br)
+
+## Licença
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Cliente HTTP para o NEXT Finance (finance.net.br).
+ * Usa autenticação via cookie de sessão (form POST login).
+ */
+export declare function saveSession(): void;
+export declare function loadSession(): boolean;
+export declare function deleteSession(): void;
+export declare function isAuthenticated(): boolean;
+export declare function getSelectedWallet(): string | null;
+export declare function logout(): void;
+export declare function login(email: string, senha: string): Promise<Record<string, unknown>>;
+/** Tenta restaurar sessão salva. Retorna true se a sessão parece válida. */
+export declare function tryRestoreSession(): Promise<boolean>;
+export declare function listarCarteiras(): Promise<unknown>;
+export declare function selecionarCarteira(idCarteira: string): Promise<Record<string, unknown>>;
+export declare function listarContas(): Promise<unknown>;
+export declare function buscarLancamentos(opts: {
+    idConta: string;
+    dataInicio?: string;
+    dataFim?: string;
+}): Promise<unknown>;

package/dist/client.js

@@ -0,0 +1,211 @@
+/**
+ * Cliente HTTP para o NEXT Finance (finance.net.br).
+ * Usa autenticação via cookie de sessão (form POST login).
+ */
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+const WEB_BASE = "https://finance.net.br";
+const SESSION_DIR = path.join(os.homedir(), ".next-finance-mcp");
+const SESSION_FILE = path.join(SESSION_DIR, "session.json");
+export function saveSession() {
+    try {
+        fs.mkdirSync(SESSION_DIR, { recursive: true });
+        const data = { cookies: [...cookieStore], savedAt: new Date().toISOString() };
+        fs.writeFileSync(SESSION_FILE, JSON.stringify(data, null, 2), "utf-8");
+    }
+    catch { /* ignora erros de I/O */ }
+}
+export function loadSession() {
+    try {
+        const raw = fs.readFileSync(SESSION_FILE, "utf-8");
+        const data = JSON.parse(raw);
+        // Aceita sessões salvas há menos de 3 dias
+        const age = Date.now() - new Date(data.savedAt).getTime();
+        if (age > 3 * 24 * 60 * 60 * 1000)
+            return false;
+        cookieStore.length = 0;
+        cookieStore.push(...data.cookies);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function deleteSession() {
+    try {
+        fs.unlinkSync(SESSION_FILE);
+    }
+    catch { /* ignora */ }
+}
+const cookieStore = [];
+function storeCookies(setCookieHeaders, domain) {
+    for (const header of setCookieHeaders) {
+        const pair = header.split(";")[0].trim();
+        const eqIdx = pair.indexOf("=");
+        if (eqIdx < 0)
+            continue;
+        const name = pair.slice(0, eqIdx).trim();
+        const value = pair.slice(eqIdx + 1).trim();
+        const existing = cookieStore.findIndex(c => c.name === name && c.domain === domain);
+        if (existing >= 0)
+            cookieStore[existing].value = value;
+        else
+            cookieStore.push({ name, value, domain });
+    }
+}
+function getCookieHeader(domain) {
+    return cookieStore
+        .filter(c => domain.includes(c.domain) || c.domain.includes(domain))
+        .map(c => `${c.name}=${c.value}`)
+        .join("; ");
+}
+function clearCookies() {
+    cookieStore.length = 0;
+}
+// ── Helpers de request ─────────────────────────────────────────────────────
+const BASE_HEADERS = {
+    "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36",
+    "Accept-Language": "pt-BR,pt;q=0.9,en;q=0.8",
+};
+async function webGet(path) {
+    const url = `${WEB_BASE}${path}`;
+    const res = await fetch(url, {
+        headers: {
+            ...BASE_HEADERS,
+            Cookie: getCookieHeader("finance.net.br"),
+            Accept: "text/html,application/xhtml+xml,application/xml;q=0.9,application/json,*/*;q=0.8",
+        },
+        redirect: "follow",
+    });
+    const setCookies = res.headers.getSetCookie?.() ?? [];
+    storeCookies(setCookies, "finance.net.br");
+    return { status: res.status, text: await res.text(), headers: res.headers };
+}
+async function webPost(path, body, contentType, followRedirect = true) {
+    const url = `${WEB_BASE}${path}`;
+    const res = await fetch(url, {
+        method: "POST",
+        headers: {
+            ...BASE_HEADERS,
+            Cookie: getCookieHeader("finance.net.br"),
+            "Content-Type": contentType,
+            Accept: "application/json, text/html, */*",
+            "X-Requested-With": "XMLHttpRequest",
+        },
+        body,
+        redirect: followRedirect ? "follow" : "manual",
+    });
+    const setCookies = res.headers.getSetCookie?.() ?? [];
+    storeCookies(setCookies, "finance.net.br");
+    return { status: res.status, text: await res.text(), location: res.headers.get("location") ?? undefined };
+}
+function extractCsrf(html) {
+    const m = html.match(/name="__RequestVerificationToken"[^>]+value="([^"]+)"/);
+    return m?.[1] ?? "";
+}
+// ── Estado da sessão ────────────────────────────────────────────────────────
+let _loggedIn = false;
+let _selectedWallet = null;
+export function isAuthenticated() { return _loggedIn; }
+export function getSelectedWallet() { return _selectedWallet; }
+export function logout() {
+    clearCookies();
+    _loggedIn = false;
+    _selectedWallet = null;
+}
+// ── Auth ────────────────────────────────────────────────────────────────────
+export async function login(email, senha) {
+    clearCookies();
+    _loggedIn = false;
+    _selectedWallet = null;
+    // 1. Pegar página de login para obter CSRF token e cookie
+    const loginPage = await webGet("/Login");
+    const csrf = extractCsrf(loginPage.text);
+    if (!csrf)
+        return { sucesso: false, mensagem: "Não foi possível obter o token CSRF da página de login." };
+    // 2. Submeter o formulário de login sem seguir redirect (para capturar cookies da resposta 302)
+    const formBody = new URLSearchParams({ Email: email, Senha: senha, __RequestVerificationToken: csrf }).toString();
+    const loginResp = await webPost("/Login", formBody, "application/x-www-form-urlencoded", false);
+    // Login bem-sucedido retorna 302 redirect para /Carteira
+    const isSuccess = loginResp.status === 302 && (loginResp.location?.includes("/Carteira") ||
+        loginResp.location?.includes("/carteira") ||
+        loginResp.location === "/");
+    if (!isSuccess) {
+        // Na resposta 302, o corpo pode estar vazio; tentar extrair mensagem de erro se houver
+        const errMsg = loginResp.text.match(/mensagemErroVal\"[^>]+value=\"([^\"]+)\"/)?.[1]?.trim()
+            ?? loginResp.text.match(/texto-mensagem-erro[^>]*>([^<]+)/)?.[1]?.trim()
+            ?? `Credenciais inválidas (status ${loginResp.status}, location: ${loginResp.location ?? "none"}).`;
+        return { sucesso: false, mensagem: errMsg };
+    }
+    _loggedIn = true;
+    saveSession();
+    return { sucesso: true, mensagem: "Login realizado com sucesso." };
+}
+/** Tenta restaurar sessão salva. Retorna true se a sessão parece válida. */
+export async function tryRestoreSession() {
+    if (!loadSession())
+        return false;
+    try {
+        // Valida se a sessão ainda funciona
+        const resp = await webGet("/CarteiraAjax/Listar");
+        if (resp.status === 200) {
+            _loggedIn = true;
+            return true;
+        }
+    }
+    catch { /* ignora */ }
+    clearCookies();
+    deleteSession();
+    return false;
+}
+// ── Carteiras ───────────────────────────────────────────────────────────────
+export async function listarCarteiras() {
+    const resp = await webGet("/CarteiraAjax/Listar");
+    if (resp.status !== 200)
+        throw new Error(`Erro ${resp.status} ao listar carteiras.`);
+    return JSON.parse(resp.text);
+}
+export async function selecionarCarteira(idCarteira) {
+    // Precisamos do CSRF token da página de carteiras
+    const cartPage = await webGet("/Carteira");
+    const csrf = extractCsrf(cartPage.text);
+    const formBody = new URLSearchParams({ __RequestVerificationToken: csrf, idCarteira }).toString();
+    // Não seguir redirect: o servidor retorna 302 → /Inicio ao selecionar com sucesso.
+    // Seguir automaticamente faz o Node.js perder os Set-Cookie do 302.
+    const resp = await webPost("/Carteira", formBody, "application/x-www-form-urlencoded", false);
+    const ok = resp.status === 302;
+    if (ok) {
+        _selectedWallet = idCarteira;
+        saveSession();
+    }
+    return { sucesso: ok, mensagem: ok ? `Carteira ${idCarteira} selecionada.` : `Falha ao selecionar carteira (${resp.status}).` };
+}
+// ── Contas ──────────────────────────────────────────────────────────────────
+export async function listarContas() {
+    const resp = await webGet("/ContaAjax/ListarTodos");
+    if (resp.status !== 200)
+        throw new Error(`Erro ${resp.status} ao listar contas.`);
+    return JSON.parse(resp.text);
+}
+// ── Lançamentos ─────────────────────────────────────────────────────────────
+//
+// O endpoint usa jQuery $.ajax padrão → form-urlencoded com chaves aninhadas:
+//   filtro[IdConta]=X&filtro[IntervaloDeDatas][DataInicio]=Y&filtro[IntervaloDeDatas][DataFim]=Z
+//
+// IdConta é OBRIGATÓRIO (cada chamada é por conta).
+export async function buscarLancamentos(opts) {
+    // DataInicio e DataFim são obrigatórios pela API; usar mês atual como default
+    const today = new Date();
+    const defaultInicio = `${today.getFullYear()}-${String(today.getMonth() + 1).padStart(2, "0")}-01`;
+    const defaultFim = today.toISOString().slice(0, 10);
+    const params = new URLSearchParams();
+    params.set("filtro[IdConta]", opts.idConta);
+    params.set("filtro[IntervaloDeDatas][DataInicio]", opts.dataInicio ?? defaultInicio);
+    params.set("filtro[IntervaloDeDatas][DataFim]", opts.dataFim ?? defaultFim);
+    params.set("filtro[ListarOrdenadoPelaDataDeModificacao]", "false");
+    const resp = await webPost("/LancamentoAjax/Filtrar", params.toString(), "application/x-www-form-urlencoded");
+    if (resp.status !== 200)
+        throw new Error(`Erro ${resp.status}: ${resp.text.slice(0, 200)}`);
+    return JSON.parse(resp.text);
+}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Servidor MCP para o NEXT Finance (finance.net.br).
+ * Login via browser (sem credenciais no chat) + persistência de sessão.
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,149 @@
+#!/usr/bin/env node
+/**
+ * Servidor MCP para o NEXT Finance (finance.net.br).
+ * Login via browser (sem credenciais no chat) + persistência de sessão.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import * as client from "./client.js";
+import { openLoginUI } from "./login-server.js";
+const server = new Server({ name: "next-finance-mcp", version: "0.3.0" }, { capabilities: { tools: {} } });
+// ── Ferramentas ─────────────────────────────────────────────────────────────
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: "login",
+            description: "Abre uma janela no browser para login seguro no NEXT Finance. " +
+                "As credenciais não passam pelo chat. Se já houver sessão salva, " +
+                "restaura automaticamente sem abrir o browser.",
+            inputSchema: { type: "object", properties: {} },
+        },
+        {
+            name: "logout",
+            description: "Encerra a sessão e remove os dados de sessão salvos.",
+            inputSchema: { type: "object", properties: {} },
+        },
+        {
+            name: "listar_carteiras",
+            description: "Lista todas as carteiras disponíveis para o usuário logado.",
+            inputSchema: { type: "object", properties: {} },
+        },
+        {
+            name: "selecionar_carteira",
+            description: "Seleciona uma carteira pelo ID (necessário antes de listar contas e lançamentos). " +
+                "Use listar_carteiras para ver os IDs disponíveis.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    id_carteira: { type: "string", description: "ID da carteira (ex: 'Pa', 'AqR')" },
+                },
+                required: ["id_carteira"],
+            },
+        },
+        {
+            name: "listar_contas",
+            description: "Lista as contas da carteira selecionada.",
+            inputSchema: { type: "object", properties: {} },
+        },
+        {
+            name: "buscar_lancamentos",
+            description: "Busca lançamentos/transações de uma conta. " +
+                "Use listar_contas para obter os IDs de conta disponíveis. " +
+                "Se não informar datas, retorna o mês atual.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    id_conta: { type: "string", description: "ID da conta (use listar_contas para descobrir)" },
+                    data_inicio: { type: "string", description: "Data início YYYY-MM-DD (padrão: 1º do mês atual)" },
+                    data_fim: { type: "string", description: "Data fim YYYY-MM-DD (padrão: hoje)" },
+                },
+                required: ["id_conta"],
+            },
+        },
+    ],
+}));
+// ── Helpers ──────────────────────────────────────────────────────────────────
+function ok(data) {
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+}
+function requireAuth() {
+    if (!client.isAuthenticated())
+        return ok({ erro: "Não autenticado. Use a ferramenta `login` primeiro." });
+    return null;
+}
+function requireWallet() {
+    if (!client.getSelectedWallet())
+        return ok({ erro: "Nenhuma carteira selecionada. Use `selecionar_carteira` após o login." });
+    return null;
+}
+// ── Execução ────────────────────────────────────────────────────────────────
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const { name, arguments: args = {} } = req.params;
+    try {
+        switch (name) {
+            // ── Login: tenta restaurar sessão salva; senão abre o browser ──────────
+            case "login": {
+                // 1. Tentar sessão salva
+                const restored = await client.tryRestoreSession();
+                if (restored) {
+                    return ok({ sucesso: true, mensagem: "Sessão restaurada automaticamente. Pronto para usar!" });
+                }
+                // 2. Abrir browser para login
+                const result = await openLoginUI(client.login);
+                return ok(result);
+            }
+            case "logout": {
+                client.logout();
+                client.deleteSession();
+                return ok({ mensagem: "Sessão encerrada e dados removidos." });
+            }
+            case "listar_carteiras": {
+                const authErr = requireAuth();
+                if (authErr)
+                    return authErr;
+                return ok(await client.listarCarteiras());
+            }
+            case "selecionar_carteira": {
+                const authErr = requireAuth();
+                if (authErr)
+                    return authErr;
+                return ok(await client.selecionarCarteira(args["id_carteira"]));
+            }
+            case "listar_contas": {
+                const authErr = requireAuth();
+                if (authErr)
+                    return authErr;
+                const walErr = requireWallet();
+                if (walErr)
+                    return walErr;
+                return ok(await client.listarContas());
+            }
+            case "buscar_lancamentos": {
+                const authErr = requireAuth();
+                if (authErr)
+                    return authErr;
+                const walErr = requireWallet();
+                if (walErr)
+                    return walErr;
+                return ok(await client.buscarLancamentos({
+                    idConta: args["id_conta"],
+                    dataInicio: args["data_inicio"],
+                    dataFim: args["data_fim"],
+                }));
+            }
+            default:
+                return ok({ erro: `Ferramenta desconhecida: ${name}` });
+        }
+    }
+    catch (err) {
+        return ok({ erro: err instanceof Error ? err.message : String(err) });
+    }
+});
+// ── Inicialização ───────────────────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("NEXT Finance MCP server v0.3.0 iniciado.");
+}
+main().catch((err) => { console.error("Erro fatal:", err); process.exit(1); });

package/dist/login-server.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Servidor HTTP local para login via browser.
+ * Abre uma janela no browser com formulário de e-mail/senha.
+ * As credenciais NUNCA passam pelo chat.
+ */
+export type LoginFn = (email: string, senha: string) => Promise<Record<string, unknown>>;
+/**
+ * Inicia servidor HTTP local, abre o browser e aguarda o usuário fazer login.
+ * Resolve quando o login for bem-sucedido ou expirar (2 min).
+ */
+export declare function openLoginUI(loginFn: LoginFn): Promise<Record<string, unknown>>;

package/dist/login-server.js

@@ -0,0 +1,205 @@
+/**
+ * Servidor HTTP local para login via browser.
+ * Abre uma janela no browser com formulário de e-mail/senha.
+ * As credenciais NUNCA passam pelo chat.
+ */
+import * as http from "http";
+import * as os from "os";
+import { exec } from "child_process";
+const LOGIN_HTML = `<!DOCTYPE html>
+<html lang="pt-br">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>NEXT Finance — Login</title>
+  <style>
+    * { box-sizing: border-box; margin: 0; padding: 0; }
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+      background: #f0f2f5;
+      display: flex; align-items: center; justify-content: center;
+      min-height: 100vh;
+    }
+    .card {
+      background: #fff;
+      border-radius: 12px;
+      box-shadow: 0 4px 24px rgba(0,0,0,.10);
+      padding: 40px 36px 32px;
+      width: 360px;
+    }
+    .logo {
+      text-align: center;
+      margin-bottom: 28px;
+    }
+    .logo h1 { font-size: 22px; color: #1a73e8; font-weight: 700; letter-spacing: -0.5px; }
+    .logo p  { font-size: 13px; color: #666; margin-top: 4px; }
+    label { display: block; font-size: 13px; color: #444; margin-bottom: 6px; font-weight: 500; }
+    input[type=email], input[type=password] {
+      width: 100%; padding: 11px 14px; border: 1.5px solid #ddd;
+      border-radius: 8px; font-size: 14px; outline: none;
+      transition: border-color .2s;
+    }
+    input:focus { border-color: #1a73e8; }
+    .field { margin-bottom: 18px; }
+    .btn {
+      width: 100%; padding: 12px; background: #1a73e8; color: #fff;
+      border: none; border-radius: 8px; font-size: 15px; font-weight: 600;
+      cursor: pointer; transition: background .2s;
+    }
+    .btn:hover { background: #1557b0; }
+    .btn:disabled { background: #aaa; cursor: default; }
+    .error {
+      background: #fdecea; color: #c62828; border-radius: 8px;
+      padding: 10px 14px; font-size: 13px; margin-bottom: 16px; display: none;
+    }
+    .secure {
+      text-align: center; font-size: 12px; color: #888; margin-top: 18px;
+    }
+    .secure span { color: #2e7d32; font-weight: 600; }
+  </style>
+</head>
+<body>
+  <div class="card">
+    <div class="logo">
+      <h1>NEXT Finance</h1>
+      <p>Entre com suas credenciais para continuar</p>
+    </div>
+    <div class="error" id="err"></div>
+    <form id="form" method="POST" action="/login">
+      <div class="field">
+        <label for="email">E-mail</label>
+        <input type="email" id="email" name="email" placeholder="seu@email.com" required autofocus>
+      </div>
+      <div class="field">
+        <label for="senha">Senha</label>
+        <input type="password" id="senha" name="senha" placeholder="••••••••" required>
+      </div>
+      <button class="btn" type="submit" id="btn">Entrar</button>
+    </form>
+    <p class="secure"><span>&#128274; Conexão local</span> — suas credenciais não passam pelo chat</p>
+  </div>
+  <script>
+    document.getElementById("form").addEventListener("submit", async (e) => {
+      e.preventDefault();
+      const btn = document.getElementById("btn");
+      const err = document.getElementById("err");
+      btn.disabled = true;
+      btn.textContent = "Autenticando…";
+      err.style.display = "none";
+
+      const data = new URLSearchParams(new FormData(e.target));
+      const res  = await fetch("/login", { method: "POST", body: data });
+      const json = await res.json();
+
+      if (json.sucesso) {
+        window.location.href = "/sucesso";
+      } else {
+        err.textContent = json.mensagem;
+        err.style.display = "block";
+        btn.disabled = false;
+        btn.textContent = "Entrar";
+      }
+    });
+  </script>
+</body>
+</html>`;
+const SUCCESS_HTML = `<!DOCTYPE html>
+<html lang="pt-br">
+<head>
+  <meta charset="utf-8">
+  <title>Login realizado — NEXT Finance</title>
+  <style>
+    * { box-sizing: border-box; margin: 0; padding: 0; }
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+      background: #f0f2f5; display: flex; align-items: center;
+      justify-content: center; min-height: 100vh;
+    }
+    .card {
+      background: #fff; border-radius: 12px;
+      box-shadow: 0 4px 24px rgba(0,0,0,.10);
+      padding: 48px 36px; width: 360px; text-align: center;
+    }
+    .icon { font-size: 56px; margin-bottom: 16px; }
+    h2 { color: #2e7d32; font-size: 20px; margin-bottom: 10px; }
+    p  { color: #555; font-size: 14px; }
+  </style>
+</head>
+<body>
+  <div class="card">
+    <div class="icon">✅</div>
+    <h2>Login realizado com sucesso!</h2>
+    <p>Pode fechar esta janela e voltar ao Claude.</p>
+  </div>
+</body>
+</html>`;
+/** Abre o browser no macOS/Linux/Windows */
+function openBrowser(url) {
+    const platform = os.platform();
+    const cmd = platform === "darwin" ? `open "${url}"` :
+        platform === "win32" ? `start "" "${url}"` :
+            `xdg-open "${url}"`;
+    exec(cmd, (err) => {
+        if (err)
+            console.error("Não foi possível abrir o browser:", err.message);
+    });
+}
+/**
+ * Inicia servidor HTTP local, abre o browser e aguarda o usuário fazer login.
+ * Resolve quando o login for bem-sucedido ou expirar (2 min).
+ */
+export function openLoginUI(loginFn) {
+    return new Promise((resolve) => {
+        let resolved = false;
+        const server = http.createServer(async (req, res) => {
+            const url = req.url ?? "/";
+            // Página inicial → formulário
+            if (req.method === "GET" && url === "/") {
+                res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+                res.end(LOGIN_HTML);
+                return;
+            }
+            // Página de sucesso
+            if (req.method === "GET" && url === "/sucesso") {
+                res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+                res.end(SUCCESS_HTML);
+                setTimeout(() => server.close(), 500);
+                return;
+            }
+            // POST de login
+            if (req.method === "POST" && url === "/login") {
+                let body = "";
+                req.on("data", (chunk) => (body += chunk));
+                req.on("end", async () => {
+                    const params = new URLSearchParams(body);
+                    const email = params.get("email") ?? "";
+                    const senha = params.get("senha") ?? "";
+                    const result = await loginFn(email, senha);
+                    res.writeHead(200, { "Content-Type": "application/json; charset=utf-8" });
+                    res.end(JSON.stringify(result));
+                    if (result["sucesso"] && !resolved) {
+                        resolved = true;
+                        resolve(result);
+                    }
+                });
+                return;
+            }
+            res.writeHead(404);
+            res.end();
+        });
+        server.listen(0, "127.0.0.1", () => {
+            const addr = server.address();
+            const url = `http://127.0.0.1:${addr.port}`;
+            console.error(`[NEXT Finance MCP] Abrindo login em ${url}`);
+            openBrowser(url);
+        });
+        // Timeout de 2 minutos
+        setTimeout(() => {
+            if (!resolved) {
+                resolved = true;
+                server.close();
+                resolve({ sucesso: false, mensagem: "Tempo de login expirado (2 min). Tente novamente." });
+            }
+        }, 120_000);
+    });
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "next-finance-mcp",
+  "version": "0.3.0",
+  "description": "MCP Server para o NEXT Finance (finance.net.br) — login via browser, listagem de carteiras, contas e lançamentos",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "next-finance-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "next-finance",
+    "finance",
+    "erp",
+    "claude",
+    "anthropic"
+  ],
+  "author": "Rodrigo Antônio de Paiva <rodrigo@paiva.com.br>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rodrigopaiva/next-finance-mcp"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  }
+}