mcp_financeiro

mcp_financeiro

3.3

If you are the rightful owner of mcp_financeiro and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The mcp_financeiro project is a Model Context Protocol (MCP) server designed to assist with personal financial analysis and planning.

mcp_financeiro

Índice

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

  1. Chamei a pasta que eu tinha acabado de criar 
    cd “C:\Users\meu_usuario\OneDrive\area_de_trabalho\MCPs\mcp_financeiro”
  2. 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.

  1. Voltando ao terminal, utilizei o comando abaixo para inicializar um novo projeto Python, criando arquivos de configuração e dependências automaticamente 
    uv init
  2. Adicionei a dependência MCP, necessária para o projeto 
    uv add mcp[cli]
  3. Verifiquei se estava tudo ok, com o comando abaixo 
    mcp

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

  1. 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.

  1. Instalei o json abaixo do MCP-Server diretamente no arquivo claude_desktop_config.json 
    "financeiro": {
  "command": "uv",
  "args": [
    "--directory",
    "C://Users//meu_usuario//OneDrive//area_de_trabalho//MCPs//mcp_financeiro",
    "run",
    "server.py"
  ]
}

[!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

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®