AI导哈

Monarch Money MCP 服务器

Monarch Money MCP 服务器是一个用于与 Monarch Money 个人财务平台集成的模型上下文协议（MCP）服务器。它通过 Claude Desktop 提供对财务账户、交易、预算和分析的无缝访问。该服务器支持账户管理、交易访问、财务分析和安全认证等功能，适用于个人财务管理、预算跟踪和财务分析等场景。

  • by robcerda
  • 2 星标
  • 更新于
在 GitHub 查看 robcerda/monarch-mcp-server

使用说明

基本能力

产品定位

Monarch Money MCP 服务器是一个用于与 Monarch Money 个人财务平台集成的 MCP 服务器，提供对财务数据的无缝访问和管理。

核心功能

  1. 账户管理：查看所有关联的财务账户、账户余额和机构信息。
  2. 交易访问：获取交易数据，支持按日期、账户和分页过滤。
  3. 财务分析：访问预算信息和现金流分析。
  4. 安全认证：支持一次性设置和多因素认证（MFA）。

适用场景

  1. 个人财务管理
  2. 预算跟踪
  3. 财务分析
  4. 交易记录管理

工具列表

工具 描述 参数
setup_authentication 获取设置说明 无
check_auth_status 检查认证状态 无
get_accounts 获取所有财务账户 无
get_transactions 获取交易数据 limit, offset, start_date, end_date, account_id
get_budgets 获取预算信息 无
get_cashflow 获取现金流分析 start_date, end_date
get_account_holdings 获取投资持仓 account_id
create_transaction 创建新交易 account_id, amount, description, date, category_id, merchant_name
update_transaction 更新现有交易 transaction_id, amount, description, category_id, date
refresh_accounts 请求账户数据刷新 无

使用教程

使用依赖

  1. 克隆仓库：

    git clone https://github.com/robcerda/monarch-mcp-server.git
cd monarch-mcp-server

  2. 安装依赖：

    pip install -r requirements.txt
pip install -e .

安装教程

  1. 配置 Claude Desktop： 在 Claude Desktop 配置文件中添加以下内容：

    macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    Windows: %APPDATA%\Claude\claude_desktop_config.json

    {
  "mcpServers": {
    "Monarch Money": {
      "command": "/opt/homebrew/bin/uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with-editable",
        "/path/to/your/monarch-mcp-server",
        "mcp",
        "run",
        "/path/to/your/monarch-mcp-server/src/monarch_mcp_server/server.py"
      ]
    }
  }
}

    注意：将 /path/to/your/monarch-mcp-server 替换为实际路径！

  2. 重启 Claude Desktop

调试方式

  1. 一次性认证设置：

    cd /path/to/your/monarch-mcp-server
python login_setup.py

  2. 常见问题：

    • 认证问题：运行 login_setup.py 并重启 Claude Desktop。
    • 会话过期：重新运行 login_setup.py。
    • 日期格式错误：使用 YYYY-MM-DD 格式。

相关 MCP