@yoryoboy/bi-mcp 1.6.0 → 1.7.0

package/README.md

@@ -1,87 +1,87 @@
-# bi-mcp
-
-`bi-mcp` es un servidor MCP de business intelligence para ecommerce en Argentina.
-
-Permite consultar datos reales de operacion, marketing y adquisicion desde un asistente compatible con MCP, usando lenguaje natural. La idea es que Julian, su equipo o un cliente puedan preguntar por ventas, canales, performance, SEO, anuncios, inventario o riesgos de negocio sin tener que entrar manualmente a cada plataforma.
-
-## Que podes consultar
-
-Hoy el MCP cubre estas areas:
-
-- **VTEX:** pedidos, stock, inventario por deposito, precios, ofertas y operaciones comerciales.
-- **Google Analytics 4:** revenue medido, trafico, canales, engagement y salud de medicion ecommerce.
-- **Search Console:** queries, paginas, CTR, oportunidades SEO y alertas de visibilidad.
-- **Google Ads:** performance de cuenta y campanas, riesgos, break-even y salud de escalabilidad.
-- **Meta Ads:** discovery de cuentas publicitarias, performance de campanas y ads, series temporales y placements.
-- **Config / Benchmarks Argentina:** referencias locales para IIBB, cuotas, pasarelas, logistica y calendario comercial.
-
-La documentacion completa de capacidades esta en [docs/CAPACIDADES_MCP.md](/home/yoryo/apps/bi-mcp/docs/CAPACIDADES_MCP.md).
-
-## Como se usa
-
-Una vez conectado el servidor a tu cliente MCP, podes hacer preguntas como:
-
-- "Como vienen las ventas de esta semana?"
-- "Que canales traen mas revenue?"
-- "Que campanas de Google Ads estan cerca del break-even?"
-- "Que queries SEO tienen muchas impresiones y bajo CTR?"
-- "Hay problemas de stock en productos importantes?"
-- "Que placements de Meta concentran el gasto?"
-
-No hace falta memorizar nombres tecnicos de herramientas. Las tools existen por detras para que el asistente pueda buscar, cruzar y resumir la informacion.
-
-## Conexion rapida
-
-Despues de publicar o instalar el paquete, una configuracion tipica por `npx` usa transporte `stdio`:
-
-```json
-{
-  "mcpServers": {
-    "bi-mcp-stdio": {
-      "command": "npx",
-      "args": ["-y", "@yoryoboy/bi-mcp"],
-      "env": {
-        "MCP_TRANSPORT": "stdio",
-        "GOOGLE_OAUTH_CLIENT_ID": "your_google_oauth_client_id",
-        "GOOGLE_OAUTH_CLIENT_SECRET": "your_google_oauth_client_secret",
-        "GA4_PROPERTY_ID": "your_ga4_property_id",
-        "GOOGLE_ADS_DEVELOPER_TOKEN": "your_google_ads_developer_token",
-        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "your_google_ads_login_customer_id",
-        "META_APP_ID": "your_meta_app_id",
-        "META_APP_SECRET": "your_meta_app_secret",
-        "META_ACCESS_TOKEN": "your_meta_access_token",
-        "META_API_VERSION": "v25.0",
-        "DATABASE_URL": "your_postgres_connection_string",
-        "DB_ENCRYPTION_KEY": "your_64_hex_char_encryption_key"
-      }
-    }
-  }
-}
-```
-
-Si no vas a usar una integracion, sus credenciales pueden no ser necesarias para ese flujo. VTEX usa perfiles y conexiones persistidas en Postgres; sus credenciales por cliente no se configuran directo en `.env`.
-
-## Variables principales
-
-El servidor lee infraestructura y secretos desde variables de entorno:
-
-- `MCP_TRANSPORT`, `PORT`, `MCP_URL`
-- `DATABASE_URL`, `DB_ENCRYPTION_KEY`
-- `GOOGLE_OAUTH_CLIENT_ID`, `GOOGLE_OAUTH_CLIENT_SECRET`
-- `GA4_PROPERTY_ID`
-- `GOOGLE_ADS_DEVELOPER_TOKEN`, `GOOGLE_ADS_LOGIN_CUSTOMER_ID`
-- `META_APP_ID`, `META_APP_SECRET`, `META_ACCESS_TOKEN`, `META_API_VERSION`
-
-La configuracion de negocio no deberia vivir en `.env`.
-
-## Documentacion util
-
-- [Capacidades del MCP](/home/yoryo/apps/bi-mcp/docs/CAPACIDADES_MCP.md): que puede responder cada modulo.
-- [Fuentes de datos](/home/yoryo/apps/bi-mcp/docs/FUENTES_DE_DATOS.md): de donde salen los datos y que limitaciones tienen.
-- [Glosario financiero](/home/yoryo/apps/bi-mcp/docs/GLOSARIO_FINANCIERO.md): terminos de negocio y finanzas usados por el sistema.
-- [Estado del proyecto](/home/yoryo/apps/bi-mcp/docs/PROJECT_STATUS.md): modulos implementados, pendientes y roadmap.
-- [Guia para agentes](/home/yoryo/apps/bi-mcp/AGENTS.md): reglas para modificar el repo.
-
-## Licencia
-
-MIT. Ver [package.json](/home/yoryo/apps/bi-mcp/package.json).
+# bi-mcp
+
+`bi-mcp` es un servidor MCP de business intelligence para ecommerce en Argentina.
+
+Permite consultar datos reales de operacion, marketing y adquisicion desde un asistente compatible con MCP, usando lenguaje natural. La idea es que Julian, su equipo o un cliente puedan preguntar por ventas, canales, performance, SEO, anuncios, inventario o riesgos de negocio sin tener que entrar manualmente a cada plataforma.
+
+## Que podes consultar
+
+Hoy el MCP cubre estas areas:
+
+- **VTEX:** pedidos, stock, inventario por deposito, precios, ofertas y operaciones comerciales.
+- **Google Analytics 4:** revenue medido, trafico, canales, engagement y salud de medicion ecommerce.
+- **Search Console:** queries, paginas, CTR, oportunidades SEO y alertas de visibilidad.
+- **Google Ads:** performance de cuenta y campanas, riesgos, break-even y salud de escalabilidad.
+- **Meta Ads:** discovery de cuentas publicitarias, performance de campanas y ads, series temporales y placements.
+- **Config / Benchmarks Argentina:** referencias locales para IIBB, cuotas, pasarelas, logistica y calendario comercial.
+
+La documentacion completa de capacidades esta en [docs/CAPACIDADES_MCP.md](/home/yoryo/apps/bi-mcp/docs/CAPACIDADES_MCP.md).
+
+## Como se usa
+
+Una vez conectado el servidor a tu cliente MCP, podes hacer preguntas como:
+
+- "Como vienen las ventas de esta semana?"
+- "Que canales traen mas revenue?"
+- "Que campanas de Google Ads estan cerca del break-even?"
+- "Que queries SEO tienen muchas impresiones y bajo CTR?"
+- "Hay problemas de stock en productos importantes?"
+- "Que placements de Meta concentran el gasto?"
+
+No hace falta memorizar nombres tecnicos de herramientas. Las tools existen por detras para que el asistente pueda buscar, cruzar y resumir la informacion.
+
+## Conexion rapida
+
+Despues de publicar o instalar el paquete, una configuracion tipica por `npx` usa transporte `stdio`:
+
+```json
+{
+  "mcpServers": {
+    "bi-mcp-stdio": {
+      "command": "npx",
+      "args": ["-y", "@yoryoboy/bi-mcp"],
+      "env": {
+        "MCP_TRANSPORT": "stdio",
+        "GOOGLE_OAUTH_CLIENT_ID": "your_google_oauth_client_id",
+        "GOOGLE_OAUTH_CLIENT_SECRET": "your_google_oauth_client_secret",
+        "GA4_PROPERTY_ID": "your_ga4_property_id",
+        "GOOGLE_ADS_DEVELOPER_TOKEN": "your_google_ads_developer_token",
+        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "your_google_ads_login_customer_id",
+        "META_APP_ID": "your_meta_app_id",
+        "META_APP_SECRET": "your_meta_app_secret",
+        "META_ACCESS_TOKEN": "your_meta_access_token",
+        "META_API_VERSION": "v25.0",
+        "DATABASE_URL": "your_postgres_connection_string",
+        "DB_ENCRYPTION_KEY": "your_64_hex_char_encryption_key"
+      }
+    }
+  }
+}
+```
+
+Si no vas a usar una integracion, sus credenciales pueden no ser necesarias para ese flujo. VTEX usa perfiles y conexiones persistidas en Postgres; sus credenciales por cliente no se configuran directo en `.env`.
+
+## Variables principales
+
+El servidor lee infraestructura y secretos desde variables de entorno:
+
+- `MCP_TRANSPORT`, `PORT`, `MCP_URL`
+- `DATABASE_URL`, `DB_ENCRYPTION_KEY`
+- `GOOGLE_OAUTH_CLIENT_ID`, `GOOGLE_OAUTH_CLIENT_SECRET`
+- `GA4_PROPERTY_ID`
+- `GOOGLE_ADS_DEVELOPER_TOKEN`, `GOOGLE_ADS_LOGIN_CUSTOMER_ID`
+- `META_APP_ID`, `META_APP_SECRET`, `META_ACCESS_TOKEN`, `META_API_VERSION`
+
+La configuracion de negocio no deberia vivir en `.env`.
+
+## Documentacion util
+
+- [Capacidades del MCP](/home/yoryo/apps/bi-mcp/docs/CAPACIDADES_MCP.md): que puede responder cada modulo.
+- [Fuentes de datos](/home/yoryo/apps/bi-mcp/docs/FUENTES_DE_DATOS.md): de donde salen los datos y que limitaciones tienen.
+- [Glosario financiero](/home/yoryo/apps/bi-mcp/docs/GLOSARIO_FINANCIERO.md): terminos de negocio y finanzas usados por el sistema.
+- [Estado del proyecto](/home/yoryo/apps/bi-mcp/docs/PROJECT_STATUS.md): modulos implementados, pendientes y roadmap.
+- [Guia para agentes](/home/yoryo/apps/bi-mcp/AGENTS.md): reglas para modificar el repo.
+
+## Licencia
+
+MIT. Ver [package.json](/home/yoryo/apps/bi-mcp/package.json).

package/bin/bi-mcp.js

@@ -1,9 +1,9 @@
-#!/usr/bin/env node
-
-if (!process.env.MCP_TRANSPORT) {
-  process.env.MCP_TRANSPORT = "stdio";
-}
-
-console.error("[bi-mcp] Effective MCP_TRANSPORT =", process.env.MCP_TRANSPORT);
-
-await import("../dist/index.js");
+#!/usr/bin/env node
+
+if (!process.env.MCP_TRANSPORT) {
+  process.env.MCP_TRANSPORT = "stdio";
+}
+
+console.error("[bi-mcp] Effective MCP_TRANSPORT =", process.env.MCP_TRANSPORT);
+
+await import("../dist/index.js");