Monarch Money Mcp

金融 Python

🚀 君主理财MCP服务器

这是一个MCP（模型上下文协议）服务器，可用于访问君主理财（Monarch Money）的财务数据并执行相关操作。

✨ 主要特性

账户管理：列出并检索账户信息。
交易操作：可按日期范围、账户和类别筛选获取交易记录。
预算分析：访问预算数据和支出洞察。
类别管理：列出并管理交易类别。
目标跟踪：访问财务目标及其进度。
净资产跟踪：随时间检索净资产快照。

📦 安装指南

克隆或下载此MCP服务器。
安装依赖项：
```
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密钥

进入君主理财设置并启用双因素认证（2FA）。
当显示二维码时，查找“无法扫描？”或“手动输入”选项。
复制密钥（它将是类似 T5SPVJIBRNPNNINFSH5W7RFVF2XYADYX 的字符串）。
将此作为你的 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 文件的访问，因为它包含敏感凭证。

0 条评论
分类：金融