Budgetsco

Gestiona finanzas personales, rastrea transacciones y crea presupuestos con Budgetsco.

GitHubPrueba este MCPPatrocinado

Documentación

Servidor MCP de Budgetsco

Servidor MCP para Budgetsco, que permite la gestión de finanzas personales mediante transacciones, presupuestos y capacidades de seguimiento financiero.

Tabla de Contenidos

Requisitos previos

  • Node.js (versión 22.x recomendada)
    • Verifica tu versión de Node.js con: node --version
  • Un token de acceso personal de Budgetsco

Configuración

  1. Clona el repositorio
  2. Crea un archivo .env en el directorio raíz con tu token de acceso de Budgetsco: 
    BUDGETSCO_ACCESS_TOKEN='your_access_token_here'
  3. Instala las dependencias: 
    npm install

Herramientas disponibles

El servidor proporciona varias herramientas para gestionar las finanzas personales:

Transacciones

  • Crear, editar y eliminar transacciones
  • Ver el historial de transacciones con filtros flexibles
  • Soporte para varios modos de pago (Efectivo, Tarjeta de Crédito, UPI, etc.)

Categorías

  • Obtener categorías predefinidas y personalizadas
  • Crear y gestionar categorías personalizadas
  • Categorizar transacciones para un mejor seguimiento financiero

Transacciones recurrentes

  • Configurar transacciones recurrentes automatizadas
  • Gestionar entradas recurrentes diarias, mensuales o anuales
  • Omitir o marcar transacciones recurrentes como completadas

Presupuestos

  • Establecer y gestionar presupuestos para diferentes categorías
  • Realizar seguimiento de la utilización del presupuesto
  • Obtener desgloses detallados del presupuesto

Moneda

  • Establecer y gestionar preferencias de moneda
  • Soporte para múltiples monedas internacionales

Desarrollo

Comandos disponibles:

  • npm run dev: Iniciar MCP Inspector contra el servidor (tsx src/server.ts)
  • npm run start: Ejecutar el servidor de producción
  • npm run build: Compilar el proyecto
  • npm run lint: Ejecutar comprobaciones de linting
  • npm run format: Formatear código
  • npm run test: Ejecutar pruebas

Configuración

Variables de entorno

  • BUDGETSCO_ACCESS_TOKEN (obligatorio): Tu token de acceso personal de Budgetsco

Configuración del cliente

Para usar este servidor MCP con clientes como Claude, añade la siguiente configuración:

{
  "mcpServers": {
    "budgetsco": {
      "command": "npx",
      "args": ["@budgetsco/mcp"],
      "env": {
        "BUDGETSCO_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.

Construido con el MCP TypeScript SDK oficial (@modelcontextprotocol/sdk). El servidor utiliza transporte stdio; registra los diagnósticos solo en stderr para que stdout permanezca reservado para JSON-RPC.