关键词

财务数据访问记账账户查询交易记录预算管理

项目简介

Monarch Money MCP 服务器是一个基于 Model Context Protocol (MCP) 实现的应用后端，它通过封装 Monarch Money TypeScript SDK，将 Monarch Money 个人财务管理应用中的账户、交易、预算、现金流等数据能力，以标准化的 MCP 工具形式提供给支持 MCP 协议的 AI 客户端使用。

主要功能点

本 MCP 服务器提供了以下核心功能，供 AI 客户端调用：

  • 账户信息查询： 获取所有账户的列表及其详细信息。
  • 账户持仓查询： 查询指定投资账户的证券持仓信息。
  • 账户历史查询： 获取指定账户的历史余额快照数据。
  • 交易记录查询： 根据日期、账户、分类、标签、关键词等多种条件过滤和查询交易记录。
  • 交易分类查询： 获取所有用户定义的交易分类列表。
  • 预算数据查询： 获取指定日期范围内的预算计划和实际支出/收入数据。
  • 现金流数据查询： 根据日期、账户、分类等条件获取现金流汇总及明细数据。
  • 金融机构查询： 获取所有已关联的金融机构信息。
  • 交易汇总查询： 获取交易记录的统计摘要信息（总收入、总支出、平均值等）。

安装步骤

  1. 确保你的系统已安装 Node.js 和 bun 或 npm。
  2. 克隆或下载该 GitHub 仓库到本地。
  3. 在项目根目录下，使用以下任一命令安装依赖： 
    bun install
# 或者
npm install

服务器配置

本 MCP 服务器通过环境变量获取 Monarch Money 的认证令牌。请确保设置 'MONARCH_TOKEN' 环境变量，其值应是你从 Monarch Money 网页版浏览器 session 中获取的认证令牌。获取方法通常是通过浏览器开发者工具查看 'monarchmoney.com' 站点的 Local Storage 或 Cookie。

对于 MCP 客户端（如 Claude Desktop），你需要配置启动该 MCP 服务器的命令。标准的 MCP 客户端配置是一个 JSON 对象，通常包含服务器名称、启动命令及其参数、工作目录和必要的环境变量。

例如，使用 Bun 启动服务器的配置信息（JSON格式）：

{
  "monarchMoney": { // 服务器的唯一标识名，可自定义
    "command": "bun", // 启动服务器的命令
    "args": ["run", "mcp"], // 传递给命令的参数，"run mcp" 是 package.json 中定义的启动脚本
    "env": {
      "MONARCH_TOKEN": "your-monarch-token-here" // MCP 服务器用于认证的环境变量
    },
    "cwd": "/path/to/your/monarch-mcp" // 项目的绝对路径，确保命令在此目录下执行
  }
}

请将上述示例中的 '"your-monarch-token-here"' 替换为你实际的 Monarch Money 认证令牌，并确保 '"cwd"' 指向你克隆仓库的本地路径。具体的配置方式请参考你的 MCP 客户端的文档。

基本使用方法

  1. 设置认证令牌： 在启动服务器的环境中设置 'MONARCH_TOKEN' 环境变量。 
    export MONARCH_TOKEN="your-monarch-token-here"
    （请替换为你的实际令牌）
  2. 启动 MCP 服务器： 在项目根目录下运行预设的脚本。 
    bun run mcp
# 或者使用 npm
# npm run mcp
    服务器会通过 Stdio 协议与 MCP 客户端通信。
  3. 连接客户端： 确保你的 MCP 客户端已配置好该服务器的启动命令，并连接到本地运行的 MCP 服务器。一旦连接成功，AI 客户端即可发现并调用此服务器提供的工具来访问你的 Monarch Money 财务数据。

信息

分类

商业系统

访问项目