Asher - Personal Financial Data MCP Server

Asher - 个人财务数据 MCP 服务

更深入地了解自己的数据，体验全面升级！

一款安全、本地优先的财务数据聚合工具，面向以色列的银行和信用卡公司，使用 TypeScript 构建，并由 israeli-bank-scrapers 提供支持。Asher 可帮助你汇总并分析来自多个来源的财务交易，同时确保数据的隐私与安全。 信息会被抓取并存储在本地的加密 SQLite 数据库中。

功能

• MCP 服务：实现 Model Context Protocol，可轻松与 MCP Host（例如 Claude）集成
• 广泛集成：支持 israeli-bank-scrapers 提供的所有以色列银行和信用卡公司。
• 本地优先：你的财务数据绝不会离开你的设备
• 加密：敏感数据在静态存储时会加密
• 命令行界面：通过命令行轻松设置和管理
• TypeScript：构建时充分考虑类型安全

先决条件

• Node.js 18+
• npm

安装

1. 克隆仓库：

   git clone https://github.com/shlomiuziel/asher-mcp.git
   cd asher-mcp
   

2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

4. 可选：全局安装 asher CLI 命令：

   npm install -g .
   

5. 全局安装 tsx（TypeScript Execute）（Claude 桌面端集成所必需）：

   npm install -g tsx
   

数据库位置

数据库文件会根据你的操作系统存储在以下位置：

• macOS： ~/Library/Application Support/Asher/database.db
• Linux： ~/.local/share/Asher/database.db
• Windows： %APPDATA%/Asher/database.db

首次运行与配置

1. 准备一个 credentials.json 文件，填入你的服务提供方凭据。 在此处查看支持的服务提供方及凭据字段。

2. 导入凭据：

   asher ingest-creds -f credentials.json
   

   • 可根据需要使用此命令更新凭据。删除凭据可手动完成（请参阅 scraper_credentials 表）。
   • 系统会提示你为数据库输入加密密钥（首次设置时，需要再次输入以确认）。

3. 设置期间，系统会提示你：

   • 启用通知（测试通知有助于确认权限）
   • 可选择执行首次抓取（建议执行，以避免因数据量较大而产生延迟和可能的超时）
   • 配置 Claude Desktop 集成（可直接通过 npm run configure:claude 启动）

使用方法

MCP 工具

Asher 为 MCP Host 提供多种工具：

• fetchTransactions：获取近期交易并存储到数据库中。
• describeTable：获取表的详细信息（列、索引）。
• listTables：列出数据库中的所有表。
• getTableSchema：获取指定表的架构。
• sqlQuery：对允许的表执行安全的 SELECT 查询（防止 SQL 注入和未经授权的访问）。
• fetch-last-month-transactions：获取并汇总上个月的交易与支出。

其中包含一个示例提示词，可帮助你生成详细的月度报告。

测试你的 MCP 服务

你可以运行 MCP Inspector 进行本地测试：

npm run start:mcp:inspector

安全

• 所有敏感数据在静态存储时都会加密。
• 银行凭据使用你的加密密钥安全地存储在数据库中。
• 应用遵循最小权限原则（数据库文件权限为 chmod 600）。
• 运行时会请求加密密钥，且绝不会将其存储在磁盘上。

测试

运行所有测试：

npm test

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。

⚠️ 重要免责声明

使用本软件前，请仔细阅读本免责声明。

本软件旨在帮助您分析财务数据，并使 MCP 主机能够访问这些数据。但是，使用本软件即表示您确认并同意以下条款：

1. 不提供保证：本软件按“原样”提供，不附带任何形式的明示或默示保证，包括但不限于适销性、特定用途适用性和不侵权保证。

2. 财务数据安全：

   • 您独自负责保护自己的银行凭据和财务数据安全
   • 切勿与任何人分享您的凭据或加密密钥
   • 开发者不对任何人未经授权访问您的金融账户负责

3. 风险自负：

   • 对于因使用本软件而造成的任何经济损失、数据丢失或其他损害，开发者概不负责
   • 请务必通过银行官方渠道核实重要财务信息
   • 本软件可能不兼容所有银行机构

4. 不承担责任：在任何情况下，无论是基于合同、侵权还是其他原因提起诉讼，因本软件或使用本软件或与本软件相关的其他交易而产生的任何索赔、损害或其他责任，作者或版权持有人均不承担责任。

5. 第三方服务：本软件可能会集成第三方服务。开发者不对这些第三方的行为、内容或政策负责。

使用本软件即表示您确认已阅读本免责声明，并同意受其条款约束。