Budgetsco

Servidor MCP Budgetsco

Servidor MCP para Budgetsco, permitindo gerenciamento de finanças pessoais por meio de transações, orçamentos e recursos de acompanhamento financeiro.

Sumário

• Pré-requisitos
• Configuração
• Ferramentas Disponíveis
• Desenvolvimento
• Configuração
• Licença

Pré-requisitos

• Node.js (versão 22.x recomendada)
  • Verifique sua versão do Node.js com: node --version
• Um token de acesso pessoal do Budgetsco

Configuração

1. Clone o repositório
2. Crie um arquivo .env no diretório raiz com seu token de acesso do Budgetsco:

   BUDGETSCO_ACCESS_TOKEN='your_access_token_here'
   

3. Instale as dependências:

   npm install
   

Ferramentas Disponíveis

O servidor fornece várias ferramentas para gerenciar finanças pessoais:

Transações

• Criar, editar e excluir transações
• Visualizar histórico de transações com filtros flexíveis
• Suporte a vários modos de pagamento (Dinheiro, Cartão de Crédito, UPI, etc.)

Categorias

• Obter categorias predefinidas e personalizadas
• Criar e gerenciar categorias personalizadas
• Categorizar transações para melhor acompanhamento financeiro

Transações Recorrentes

• Configurar transações recorrentes automatizadas
• Gerenciar entradas recorrentes diárias, mensais ou anuais
• Pular ou marcar transações recorrentes como concluídas

Orçamento

• Definir e gerenciar orçamentos para diferentes categorias
• Acompanhar a utilização do orçamento
• Obter detalhamentos completos do orçamento

Moeda

• Definir e gerenciar preferências de moeda
• Suporte a múltiplas moedas internacionais

Desenvolvimento

Comandos disponíveis:

• npm run dev: Iniciar o Inspetor MCP contra o servidor (tsx src/server.ts)
• npm run start: Executar o servidor de produção
• npm run build: Compilar o projeto
• npm run lint: Executar verificações de lint
• npm run format: Formatar código
• npm run test: Executar testes

Configuração

Variáveis de Ambiente

• BUDGETSCO_ACCESS_TOKEN (obrigatório): Seu token de acesso pessoal do Budgetsco

Configuração do Cliente

Para usar este servidor MCP com clientes como Claude, adicione a seguinte configuração:

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

Licença

Este projeto está licenciado sob a Licença MIT. Consulte o arquivo LICENÇA para obter detalhes.

---

Construído com o SDK TypeScript MCP oficial (@modelcontextprotocol/sdk). O servidor usa transporte stdio; registre diagnósticos apenas em stderr para que o stdout permaneça reservado para JSON-RPC.