What is Mcp Financeiro

mcp_financeiro is a MCP-Server designed to calculate the ideal income and perform a brief analysis of an individual’s financial health. It provides insights based on total expenses and hours worked in a month.

Use cases

Use cases for mcp_financeiro include personal budgeting, financial goal setting, retirement planning, and educational expense management, helping users to make informed financial decisions.

How to use

To use mcp_financeiro, install it on Claude Desktop following the provided installation instructions. Input your total expenses and hours worked to receive personalized financial analysis and recommendations.

Key features

Key features include calculation of ideal monthly income, hourly wage, financial health assessment, and personalized tips based on essential expenses, goals, retirement, education, and discretionary spending.

Where to use

mcp_financeiro can be used in personal finance management, budgeting, and financial planning across various demographics, including individuals seeking to improve their financial literacy.

mcp_financeiro

Índice

• Introdução
• Estrutura do projeto
• Tecnologias utilizadas
• Requisitos
• Como instalar no Claude Desktop
• Links úteis
• Contribuições
• Licença
• Contato

Introdução

Este projeto mcp_financeiro oferece uma ferramenta para análise e planejamento financeiro pessoal. Ele calcula uma “grana ideal” baseada nos gastos totais e horas trabalhadas no mês, determinando a receita mensal ideal e o valor da hora de trabalho. Além disso, a ferramenta avalia a saúde financeira do usuário com base na receita real e oferece dicas personalizadas, considerando gastos essenciais, objetivos, aposentadoria, educação e gastos livres.

Estrutura do projeto

Este projeto leva em consideração as explicações do professor Sandeco Macedo, da UFG (Universidade Federal de Goiás), sobre MCPs por meio do livro MCP e A2A para Leigos
. É um MCP-Server simples que utiliza somente o pacote FastMCP, seguindo também as orientações do repositório oficial do Model Context Protol, da Anthropic.

Como referência para a fórmula de economia 70/30, utilizada neste MCP-server, utilizei os ensinamentos do livro “Me Poupe! 10 passos para nunca mais faltar dinheiro no seu bolso”

Este MCP-Server tem as seguintes classes:

• tool --> É uma tool que calcula o valor ideal mensal que a pessoa deve receber e quanto custa a hora dela. Sendo que o argumento ‘gastos_totais’ é o valor total que a pessoa gasta no mês e ‘horas_mes’ é a quantidade de horas que a
  pessoa trabalha no mês. A partir disso, a função retorna uma string com uma explicação do cenário atual da pessoa.
• resource --> Retorna o conteúdo bruto do arquivo dicas_financeiras.md do projeto.
• prompt --> Prompt para acionar a tool ‘grana_ideal’ e, a partir disso, fazer uma análise da saúde financeira. O argumento ‘gastos_totais’ é o valor total que a pessoa gasta no mês, ‘horas_mes’ é a quantidade de horas que a
  pessoa trabalha no mês, ‘receita_real’ é a média de quanto a pessoa ganha por mês, ‘perfil_de_investimento’ é o perfil de investimento da pessoa (conservador, moderado ou arrojado), ‘trabalho’ é o que a pessoa faz para ganhar dinheiro e ‘hobby’ é o que a pessoa costuma fazer para se entreter.

Tecnologias utilizadas

                   

Requisitos

• Python instalado (versão 3.10 ou superior);
• Pacote uv instalado;
• Claude Desktop instalado.

Como instalar no Claude Desktop

Installing via Smithery

To install mcp_financeiro for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @marioluciofjr/mcp_financeiro --client claude

Agora vou detalhar um passo a passo no Windows 11, utilizando o terminal (atalho CTRL + J) no VSCode:

1. Instalei a versão mais atualizada do Python
2. Já no VSCode, eu utizei o terminal para verificiar a versão do python com o comando

   python --version
   

3. Depois eu instalei o uv com o comando

   pip install uv
   

4. Para conferir se estava tudo certo, eu utilizei o comando

   uv
   

5. Para criar a pasta do projeto, eu utilizei este comando

   mkdir “C:\Users\meu_usuario\OneDrive\area_de_trabalho\MCPs\mcp_financeiro”
   

[!IMPORTANT]
Não necessariamente quer dizer que você utilizará o mesmo caminho, pode ser que você queira utilizar outro caminho, como este abaixo

  mkdir "C:\Users\seu_usuario\mcp_financeiro"

Ou você pode simplesmente fazer o download do zip desse projeto para a sua máquina pelo caminho Code > Download ZIP aqui mesmo no GitHub

6. Chamei a pasta que eu tinha acabado de criar

   cd “C:\Users\meu_usuario\OneDrive\area_de_trabalho\MCPs\mcp_financeiro”
   

7. Utilizei o comando abaixo para abrir outra janela do VSCode e continuar com os demais comandos direto na pasta

   code .
   

[!IMPORTANT]
Se não quiser criar a pasta via terminal, você pode criar uma nova pasta na sua área de trabalho ou outro local que se lembre facilmente, a fim de utilizar o atalho no VSCode
CTRL + O
Depois é só procurar a pasta que acabou de criar, clicar nela e abrir no VSCode. Ou somente importar a pasta completa desse repositório no seu VSCode.

8. Voltando ao terminal, utilizei o comando abaixo para inicializar um novo projeto Python, criando arquivos de configuração e dependências automaticamente

   uv init
   

9. Adicionei a dependência MCP, necessária para o projeto

   uv add mcp[cli]
   

10. Verifiquei se estava tudo ok, com o comando abaixo

    mcp
    

[!IMPORTANT]
Se aparecer esta informação abaixo no seu terminal é porque está tudo certo

11. Para criar o arquivo server.py, eu utilizei esse comando

    uv init --script server.py
    

[!TIP]
Como você pode já ter baixado a pasta desse repositório, então o arquivo server.pyjá estará lá no seu VSCode nessa altura do campeonato.

12. Instalei o json abaixo do MCP-Server diretamente no arquivo claude_desktop_config.json

[!IMPORTANT]
Se você já instalou o Claude Desktop corretamente, siga o caminho para acessar o arquivo claude_desktop_config.json no seu computador
12a. Com o Claude Desktop aberto, utilize o atalho CTRL + ,
12b. Clique na aba Desenvolvedor e depois em Editar configuração
12c. Procure o arquivo claude_desktop_config.json e edite no VSCode corretamente
12d. Salve o arquivo com CTRL + S
12e. Feche o Claude Desktop e abra novamente depois de alguns segundos
12f. Confira no ícone de configuração se a ferramenta do MCP “mcp_financeiro” está instalada corretamente

A ferramenta foi nomeada como grana_ideal.

12g. Para utilizar, você deve clicar no ícone de ‘+’ e, na opção Adicionar do financeiro, clicar no resourse file://dicas_financeiras. Refaça o caminho e clique no prompt chamado saude_financeira também.

12h. Ao clicar no prompt saude_financeira, aparecerá um formulário. Basta preencher e clicar no botão Adicionar prompt e executar no Claude Desktop.

Links úteis

• Documentação oficial do Model Context Protocol - Você saberá todos os detalhes dessa inovação da Anthropic
• Site oficial da Anthropic - Para ficar por dentro das novidaddes e estudos dos modelos Claude
• Como baixar o Claude Desktop - Link direto para download
• Como instalar o VSCode- Link direto para download
• Documentação oficial do pacote uv - Você saberá todos os detalhes sobre o uv e como ele é importante no python
• venv — Criação de ambientes virtuais - Explicação completa de como funcionam os venvs
• Conjunto de ícones de modelos de IA/LLM - site muito bom para conseguir ícones do ecossistema de IA
• Devicon - site bem completo também com ícones gerais sobre tecnologia
• Simulador do Tesouro Direto - simulador que possibilita entender qual é o melhor título público de acordo com o seu perfil de investimento
• Status Invest - site referência no quesito de análise fundamentalista
• Trading Economics - Site com vários indicadores, excelente para análises econômicas e geopolíticas

Contribuições

Contribuições são bem-vindas! Se você tem ideias para melhorar este projeto, sinta-se à vontade para fazer um fork do repositório.

Licença

Este projeto está licenciado sob a licença MIT - veja o arquivo LICENSE para detalhes.

Contato

Mário Lúcio - Prazo Certo®