mcp_financeiro

!license - MIT !site - prazocerto.me !linkedin - @marioluciofjr

Í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”
   

  mkdir "C:\Users\seu_usuario\mcp_financeiro"

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 .
   

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
    

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

    uv init --script server.py
    

12. 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"
      ]
    }
    

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®