opf-br-mcp 0.4.0 → 0.5.1

package/README.md

@@ -63,7 +63,7 @@ de um `search`. Assim o agente localiza o endpoint/schema certo pagando poucos
 tokens e só "paga" o payload integral quando pede um item nomeado.
 
 Dados: extraídos das fontes públicas na primeira consulta (lazy), cache em
-`~/.cache/opf-br-mcp/` com TTL de 24h. Sem rede, serve cache expirado com aviso.
+`~/.cache/opf-br-mcp/` com TTL de 72h. Sem rede, serve cache expirado com aviso.
 
 ## Instalação
 
@@ -81,6 +81,27 @@ GitHub Copilot (VS Code) — `.vscode/mcp.json`:
 { "servers": { "opf-br": { "command": "npx", "args": ["-y", "opf-br-mcp"] } } }
 ```
 
+Claude Desktop — `claude_desktop_config.json` (Settings → Developer → Edit Config):
+
+```json
+{ "mcpServers": { "opf-br": { "command": "npx", "args": ["-y", "opf-br-mcp"] } } }
+```
+
+### Windows
+
+No Windows, o client não consegue executar `npx` diretamente (é o shim
+`npx.cmd`) e acaba abrindo um `cmd.exe` interativo, cujo banner
+(`Microsoft Windows [Version ...]`) vaza para o canal stdio e corrompe o
+protocolo JSON-RPC — o servidor falha na conexão com erros de JSON inválido.
+Envolva o comando em `cmd /c` para rodá-lo sem shell interativo:
+
+```json
+{ "mcpServers": { "opf-br": { "command": "cmd", "args": ["/c", "npx", "-y", "opf-br-mcp"] } } }
+```
+
+Vale para qualquer client no Windows (Claude Desktop, Claude Code, VS Code) —
+ajuste apenas a chave externa (`mcpServers` ou `servers`).
+
 ### Uso local (a partir do fonte)
 
 ```bash

package/dist/index.js

@@ -46,7 +46,7 @@ function isFresh(entry, ttlHours, now = /* @__PURE__ */ new Date()) {
 }
 
 // src/core/version.ts
-var PACKAGE_VERSION = "0.4.0";
+var PACKAGE_VERSION = "0.5.0";
 
 // src/core/data.ts
 async function getDomainData(domain, force = false, ctx) {
@@ -254,6 +254,25 @@ function parseAdditionalInfoTables(html) {
 }
 
 // src/domains/pcm-additional-info/index.ts
+function definicaoSnippet(text2, max = 120) {
+  if (text2.length <= max) return text2;
+  const slice = text2.slice(0, max);
+  const lastSpace = slice.lastIndexOf(" ");
+  const cut = lastSpace > 0 ? slice.slice(0, lastSpace) : slice;
+  return `${cut.trimEnd()}\u2026`;
+}
+function summarizePcm(item) {
+  const summary = {
+    campo: item.campo,
+    tipo: item.tipo ?? null,
+    versoes: item.versoes,
+    roles: item.roles,
+    id: item.id,
+    page: item.page
+  };
+  if (item.definicao) summary.definicaoSnippet = definicaoSnippet(item.definicao);
+  return summary;
+}
 function slugify(text2) {
   return text2.normalize("NFD").replace(/[̀-ͯ]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
 }
@@ -278,7 +297,7 @@ function buildItems(pages) {
 var pcmDomain = {
   id: "pcm-additional-info",
   title: "PCM \u2014 Regras de obrigatoriedade do additionalInfo",
-  description: "Regras de preenchimento do campo additionalInfo das p\xE1ginas PCM (Plataforma de Coleta de M\xE9tricas) do Confluence do Open Finance Brasil (Inicia\xE7\xE3o de Pagamentos, Pagamentos Autom\xE1ticos, Sem Redirecionamento, DC-*). Cada item \xE9 um campo com regra, m\xE9todos, endpoints, vers\xF5es, tamanho m\xE1ximo e exemplo.",
+  description: "Regras de preenchimento do campo additionalInfo das p\xE1ginas PCM (Plataforma de Coleta de M\xE9tricas) do Confluence do Open Finance Brasil (Inicia\xE7\xE3o de Pagamentos, Pagamentos Autom\xE1ticos, Sem Redirecionamento, DC-*). Cada item \xE9 um campo com regra, m\xE9todos, endpoints, vers\xF5es, tamanho m\xE1ximo e exemplo. search devolve resumos; use get_item para o registro completo.",
   ttlHours: 24,
   filters: [
     { name: "field", description: "Match exato no nome do campo (case-insensitive)" },
@@ -323,7 +342,7 @@ var pcmDomain = {
         if (!matchesQuery(haystack, query)) return false;
       }
       return true;
-    });
+    }).map(summarizePcm);
   },
   getItem(data, id) {
     return data.items.find((i) => i.id === id) ?? null;
@@ -1107,7 +1126,7 @@ function createServer() {
     "get_item",
     {
       title: "Detalhar um item",
-      description: "Devolve o registro completo de um item pelo `id` retornado por search (nos dom\xEDnios *-openapi e participantes inclui o n\xF3 integral da spec em `detail`).",
+      description: "Devolve o registro completo de um item pelo `id` retornado por search (nos dom\xEDnios *-openapi e participantes inclui o n\xF3 integral da spec em `detail`; em pcm-additional-info devolve o registro completo, enquanto search devolve apenas um resumo).",
       inputSchema: {
         domain: domainIdSchema,
         id: z.string().describe("Id do item (vindo de search)")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opf-br-mcp",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "MCP server local com as regras do Open Finance Brasil (PCM additionalInfo, specs OpenAPI de Pagamentos)",
   "type": "module",
   "license": "MIT",