AI导哈

金融服务协议服务器

一个提供Monarch Money金融数据访问和操作的MCP服务器，支持账户管理、交易操作、预算分析等功能。

  • by colvint
  • Python
  • 本地部署
  • 16 星标
  • 更新于
在 GitHub 查看 colvint/monarch-money-mcp

使用说明

君主货币MCP服务器

已存档，支持现在正式支持的 君主货币连接器

MCP（模型上下文协议）服务器，提供对Monarch Money财务数据和操作的访问。

特性

  • 账户管理：列出并检索帐户信息
  • 交易操作：通过按日期范围、帐户和类别进行筛选来获取交易
  • 预算分析：获取预算数据和支出见解
  • 品类管理：列出并管理交易类别
  • 目标跟踪：实现财务目标和进展
  • 净值追踪：检索随时间变化的净值快照

安装

  1. 克隆或下载此MCP服务器
  2. 安装依赖项：
    cd /path/to/monarch-money-mcp
uv sync

配置

将服务器添加到您的 .mcp.json 配置文件：

{
  "mcpServers": {
    "monarch-money": {
      "command": "/path/to/uv",
      "args": [
        "--directory", 
        "/path/to/monarch-money-mcp",
        "run",
        "python",
        "server.py"
      ],
      "env": {
        "MONARCH_EMAIL": "your-email@example.com",
        "MONARCH_PASSWORD": "your-password",
        "MONARCH_MFA_SECRET": "your-mfa-secret-key"
      }
    }
  }
}

重要提示：

  • 替换 /path/to/uv 与您的完整路径 uv 可执行文件（用 which uv)
  • 替换 /path/to/monarch-money-mcp 此服务器目录的绝对路径
  • 使用绝对路径，而不是相对路径

获取你的MFA秘密

  1. 转到Monarch Money设置并启用2FA
  2. 当显示二维码时，寻找“无法扫描？”或“手动输入”选项
  3. 复制密钥（它将是一个类似字符串的 T5SPVJIBRNPNNINFSH5W7RFVF2XYADYX)
  4. 将此用作您的 MONARCH_MFA_SECRET

可用工具

get_accounts

列出所有账户及其余额和详细信息。

get_transactions

使用可选筛选获取交易：

  • start_date：筛选从此日期（YYYY-MM-DD）开始的交易
  • end_date：筛选到此日期（YYYY-MM-DD）的交易记录
  • account_ids：要筛选的帐户ID列表
  • category_ids：要筛选的类别ID列表
  • limit：要返回的最大交易数

get_categories

列出所有交易类别。

get_budgets

获取预算信息和支出分析。

get_goals

列出财务目标及其进展。

get_cashflow

获取现金流数据以进行收入和支出分析。

get_investments

获取投资账户详细信息和业绩。

get_net_worth

随着时间的推移，获取净值快照。

使用示例

基本账户信息

Use the get_accounts tool to see all my accounts and their current balances.

交易分析

Get all transactions from January 2024 using get_transactions with start_date "2024-01-01" and end_date "2024-01-31".

预算追踪

Show me my current budget status using the get_budgets tool.

会话管理

服务器自动管理身份验证会话：

  • 会话缓存在 .mm 用于更快后续登录的目录
  • 会话缓存是自动创建和管理的
  • 使用 MONARCH_FORCE_LOGIN=true 在env部分中，如果需要，强制重新登录

故障排除

MFA问题

  • 确保您的MFA密钥正确且格式正确
  • 尝试设置 MONARCH_FORCE_LOGIN=true 在你的 .mcp.json env部分
  • 检查您的系统时间是否准确（TOTP需要）

连接问题

  • 验证您的电子邮件和密码是否正确 .mcp.json
  • 检查您的互联网连接
  • 尝试直接运行服务器以查看详细的错误消息：
    uv run server.py

会话问题

  • 删除 .mm 用于清除缓存会话的目录
  • 集 MONARCH_FORCE_LOGIN=true 在你的 .mcp.json env部分暂时

鸣谢

MCP服务器

  • 作者：金牛座科尔文(@科尔文特)
  • 描述：Monarch Money的MCP（模型上下文协议）服务器包装器

MonarchMoney Python库

此MCP服务器封装了monrchmoney Python库，通过模型上下文协议提供与AI助手的无缝集成。

安全说明

  • 将您的凭据安全地保存在您的 .mcp.json 文件
  • MFA密码提供对您帐户的完全访问权限-将其视为密码
  • 会话文件位于 .mm 目录包含身份验证令牌-确保其安全
  • 考虑限制访问您的 .mcp.json 文件，因为它包含敏感凭据

相关 MCP