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 文件的訪問，因為它包含敏感憑證。