基本能力
产品定位
Monarch Money MCP 服务器是一个用于与 Monarch Money 个人财务平台集成的 MCP 服务器，提供对财务数据的无缝访问和管理。
核心功能
- 账户管理：查看所有关联的财务账户、账户余额和机构信息。
- 交易访问：获取交易数据，支持按日期、账户和分页过滤。
- 财务分析：访问预算信息和现金流分析。
- 安全认证：支持一次性设置和多因素认证（MFA）。
适用场景
- 个人财务管理
- 预算跟踪
- 财务分析
- 交易记录管理
工具列表
| 工具 | 描述 | 参数 |
|---|---|---|
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 | 请求账户数据刷新 | 无 |
使用教程
使用依赖
- 克隆仓库：
git clone https://github.com/robcerda/monarch-mcp-server.git
cd monarch-mcp-server- 安装依赖：
pip install -r requirements.txt
pip install -e .安装教程
- 配置 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 替换为实际路径！
- 重启 Claude Desktop
调试方式
- 一次性认证设置：
cd /path/to/your/monarch-mcp-server
python login_setup.py- 常见问题：
- 认证问题：运行 login_setup.py 并重启 Claude Desktop。 - 会话过期：重新运行 login_setup.py。 - 日期格式错误：使用 YYYY-MM-DD 格式。