SZ

sakost/zenmoney-mcp

部署与 DevOps

本页由 AI 翻译,技术细节请以原文为准。 查看原文

19 stars 7 forks 质量 62 趋势 30

MCP 服务器包装 ZenMoney 个人财务 API

概览

MCP服务器包装"ZenMoney"个人财务API. 通过"模型背景协议"将工具(同步,读取,搜索,写出,批量)在stdio上曝光,允许LLM助手与你的ZenMoney数据互动. 使用MCP总是会给您的数据带来一定的风险,特别是在领养的早期阶段. 您或其他决定用ZenMoney来尝试MCP的用户可能会想制作备份(包括每日备份到Telegram)并恢复其测试账户. 见zentable.ru/后卫和zentable.ru/后卫/后卫. 在创建测试账户时,从不同的手机或被克隆的应用中完成. 否则,你的银行同步功能在切换回主账户时可能会中断. 从最新版本下载您的平台的档案, 对照随附的.sha256文件进行校验, 并在您的 PATH 上某处解开 zenmoney-mcp 二进制 。 要使用此服务器, 您需要 ZenMoney API 访问令牌 .

概述(AI 翻译)

MCP服务器包装"ZenMoney"个人财务API.

通过"模型背景协议"将工具(同步,读取,搜索,写出,批量)在stdio上曝光,允许LLM助手与你的ZenMoney数据互动.

** 发言:** 使用MCP总是会给您的数据带来一定的风险,特别是在领养的早期阶段. 您或其他决定用ZenMoney来尝试MCP的用户可能会想制作备份(包括每日备份到Telegram)并恢复其测试账户. 见zentable.ru/后卫和zentable.ru/后卫/后卫. 翻译: ** 重要性:** 在创建测试账户时,从不同的手机或被克隆的应用中完成. 否则,你的银行同步功能在切换回主账户时可能会中断.

□ 安装

++ 预建二进制

从您的平台下载归档 最近发布, 对照.sha256的随附文件加以核实,并解开 zenmoney-mcp在您[T2]上某处的二进制.

QQ平台 QQ存档QQ | – – – – – – – | Linux x86 64 | zenmoney-mcp-x86_64-unknown-linux-gnu- .tar.gz. | Linux ARM64 | zenmoney-mcp-aarch64-unknown-linux-gnu- .tar.gz. [T5] (中文(简体) )

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

zenmoney-mcp

MCP server wrapping the ZenMoney personal finance API.

Exposes tools (sync, read, search, write, bulk) via the Model Context Protocol over stdio, allowing LLM assistants to interact with your ZenMoney data.

Caution: Using MCP always carries a certain risk to your data, especially in the early stages of adoption. You or other users who decide to try MCP with ZenMoney may want to make backups (including daily backups to Telegram) and restore them to test accounts. See zentable.ru/backup and zentable.ru/backup/restore.

Important: When creating a test account, do it from a different phone or a cloned app. Otherwise, your bank synchronizations may break when you switch back to your main account.

Installation

Prebuilt binaries

Download the archive for your platform from the latest release, verify it against the accompanying .sha256 file, and unpack the zenmoney-mcp binary somewhere on your PATH.

Platform Archive
Linux x86_64 zenmoney-mcp-x86_64-unknown-linux-gnu-.tar.gz
Linux ARM64 zenmoney-mcp-aarch64-unknown-linux-gnu-.tar.gz
macOS Intel zenmoney-mcp-x86_64-apple-darwin-.tar.gz
macOS Apple Silicon zenmoney-mcp-aarch64-apple-darwin-.tar.gz
Windows x86_64 zenmoney-mcp-x86_64-pc-windows-msvc-.zip

With cargo-binstall:

cargo binstall zenmoney-mcp

From source

cargo install zenmoney-mcp

Getting a Token

To use this server, you need a ZenMoney API access token. You can obtain one by creating an application at ZenMoney API and following the OAuth2 flow, or by extracting the token from the ZenMoney web app (see the ZenMoney API documentation for details).

Usage

ZENMONEY_TOKEN= zenmoney-mcp

The server performs an initial sync on startup, then serves MCP tools over stdio.

Claude Desktop Integration

Add the following to your Claude Desktop config file:

OS Config path
macOS ~/Library/Application Support/Claude/claude_desktop_config.json
Windows %APPDATA%\Claude\claude_desktop_config.json
Linux ~/.config/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "zenmoney": {
      "command": "zenmoney-mcp",
      "env": {
        "ZENMONEY_TOKEN": "your-token-here"
      }
    }
  }
}

Replace your-token-here with your ZenMoney API token, then restart Claude Desktop.

Tools

Sync

  • sync — incremental sync with ZenMoney server
  • full_sync — full re-download of all data

Read

  • list_accounts — list financial accounts (filter by active)
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "zenmoney": { "command": "zenmoney-mcp", "env": { "ZENMONEY_TOKEN": "your-token-here" } } } }