财务规划工具

mcp_financeiro是一款基于Python的个人财务分析与规划工具,通过计算理想月收入和工作时值评估财务健康状况,并提供个性化建议。

  • by marioluciofjr
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 marioluciofjr/mcp_financeiro

使用说明

mcp_财务

索引

介绍

这个项目 mcp_financeiro 它提供了一个用于个人财务分析和规划的工具。它根据每月的总支出和工作时间计算“理想工资”,确定理想的月收入和工作时间的价值。此外,该工具还根据实际收入评估用户的财务状况,并提供个性化的建议,考虑到基本开支,目标,退休,教育和免费开支。

项目结构

本项目考虑了UFG(戈亚斯联邦大学)Sandeco Macedo教授通过本书对MCP的解释 普通人的MCP和A2A 它是一个简单的 MCP 服务器,只使用 FastMCP 软件包,并遵循官方 模型上下文原型,da人类学。

作为这个MCP服务器中使用的70/30经济公式的参考,我使用了本书中的教训。 节省我!10个步骤,以便永远不再缺钱

此 MCP 服务器具有以下类别:

  • tool --> 这是一个计算一个人每月应该得到的理想价值以及每小时的成本的工具。其中,“花费_总”是人们每个月花费的总金额,“小时_月”是人们每个月花费的小时数。 人每个月工作。从那里,函数返回一个字符串,解释该人当前场景。
  • resource --> 返回文件的原始内容 dicas_financeiras.md 从项目。
  • prompt --> 启动“grana_ideal”工具并从中进行财务健康分析的提示。 “花费_总”是每个月花费的总数,“小时_月”是每个月花费的小时数。 一个人每月工作,“收入_实际”是这个人每月的平均收入,“投资_简介”是这个人的投资简介(保守,温和或大胆),“工作”是这个人为了赚钱而做的事情,“爱好”是这个人通常为了娱乐而做的事情。

使用的技术

                   

要求

  • 已安装 Python(3.10 或更高版本);
  • 包装 uv instalado;
  • Claude桌面实例。

如何安装 Claude Desktop

通过Smithery安装

通过以下方式自动安装适用于Claude Desktop的mcp_financeiro 史密瑟里:

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

现在我将详细介绍一步一步在Windows 11,使用终端(快捷方式) CTRL + J)无VSCode:

  1. 实例a 最新版本的 Python
  2. 在VSCode中,我使用终端使用命令检查python版本
    python --version
    
  3. 然后我安装了 uv 与命令
    pip install uv
    
  4. 为了检查一切是否正常,我使用了命令
    uv
    
  5. 为了创建工程文件夹, 我使用了这个命令
    mkdir “C:\Users\meu_usuario\OneDrive\area_de_trabalho\MCPs\mcp_financeiro”
    

[!重要] 这并不一定意味着您将使用相同的路径,您可能希望使用另一种路径,如下面

  mkdir "C:\Users\seu_usuario\mcp_financeiro"

或者,您可以简单地将该项目的zip下载到您的计算机上 Code > Download ZIP 在GitHub上

  1. 我调用了刚刚创建的文件夹
    cd “C:\Users\meu_usuario\OneDrive\area_de_trabalho\MCPs\mcp_financeiro”
    
  2. 我使用下面的命令打开另一个VSCode窗口,并直接在文件夹中继续使用其他命令
    code .
    

[!重要] 如果您不想通过终端创建文件夹,您可以在桌面或其他容易记住的位置创建新文件夹,以便使用VSCode中的快捷方式 CTRL + O 然后只需搜索刚刚创建的文件夹,单击它并在VSCode中打开。或者只需将该仓库的完整文件夹导入到您的 VSCode 中。

  1. 回到终端,我使用下面的命令启动一个新的Python项目,自动创建配置文件和依赖关系
    uv init
    
  2. 添加了工程所需的 MCP 依赖项
    uv add mcp[cli]
    
  3. 我检查了下面的命令是否一切正常
    mcp
    

[!重要] 如果下面的信息出现在您的终端上,那是因为一切都很好

  1. 创建文件 server.py我使用了这个命令。
    uv init --script server.py
    

[!提示] 因为你可能已经下载了这个仓库的文件夹,然后文件 server.py您的VSCode将在锦标赛时出现。

  1. 直接在文件中安装MCP-Server下面的json claude_desktop_config.json
    "financeiro": {
      "command": "uv",
      "args": [
        "--directory",
        "C://Users//meu_usuario//OneDrive//area_de_trabalho//MCPs//mcp_financeiro",
        "run",
        "server.py"
      ]
    }
    

[!重要] 如果您已经正确安装了 Claude Desktop,请按照路径访问该文件 claude_desktop_config.json 在您的计算机上
12A。当 Claude Desktop 打开时,请使用快捷键 CTRL + ,
12b。Clique na aba Desenvolvedor 然后在 Editar configuração
12C。搜索文件 claude_desktop_config.json 并正确编辑VSCode
12D。文件另存为 CTRL + S
十二。关闭 Claude Desktop 并在几秒钟后重新打开
12F。在配置图标中检查 MCP 工具“mcp_financial”是否已正确安装

该工具被命名为 grana_ideal.

12克。要使用, 你必须点击“+”图标和, 在选项 Adicionar do financeiro,陈词滥调没有资源 file://dicas_financeiras重新设置路径并单击所调用的提示符 saude_financeira 也是

12小时当点击提示符时 saude_financeira将出现一个表格。只需填写并点击按钮 Adicionar prompt e执行者无克劳德桌面。

链接úteis

贡献

欢迎捐款!如果您有改进此项目的想法,请随时从仓库中分叉。

许可证

这个项目是根据麻省理工学院许可证授权的 - 查看文件 许可证 为了细节。

联系方式

马里奥·卢西奥《正确的日期》®