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. 进入君主理财设置并启用双因素认证（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

随时间获取净资产快照。

💻 使用示例

基础用法

使用 get_accounts 工具查看所有账户及其当前余额。

高级用法

使用 get_transactions 工具，通过设置 start_date 为 "2024-01-01" 和 end_date 为 "2024-01-31"，获取2024年1月的所有交易记录。

使用 get_budgets 工具查看当前预算状态。

🔧 技术细节

会话管理

服务器会自动管理认证会话：

• 会话会缓存在 .mm 目录中，以便后续更快登录。
• 会话缓存会自动创建和管理。
• 若需要，可在 env 部分设置 MONARCH_FORCE_LOGIN=true 来强制进行全新登录。

故障排除

MFA问题

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

连接问题

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

  uv run server.py
  

会话问题

• 删除 .mm 目录以清除缓存的会话。
• 临时在 .mcp.json 的 env 部分设置 MONARCH_FORCE_LOGIN=true。

📄 许可证

MCP服务器

• 作者：Taurus Colvin (@colvint)
• 描述：用于君主理财的MCP（模型上下文协议）服务器包装器。

君主理财Python库

• 作者：hammem (@hammem)
• 仓库：https://github.com/hammem/monarchmoney
• 许可证：MIT许可证
• 描述：提供对君主理财API访问的底层Python库。

此MCP服务器包装了君主理财Python库，以通过模型上下文协议与AI助手实现无缝集成。

🔒 安全注意事项

• 请在 .mcp.json 文件中妥善保管你的凭证。
• MFA密钥可完全访问你的账户，请像对待密码一样对待它。
• .mm 目录中的会话文件包含认证令牌，请妥善保管。
• 考虑限制对 .mcp.json 文件的访问，因为它包含敏感凭证。