君主-MCP服务器

基本能力

产品定位

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格式。