Asher - 个人财务数据MCP服务器

更接近您的数据，更加强大！

Asher是一款安全的本地优先金融数据聚合器，适用于以色列银行和信用卡公司，使用TypeScript构建，并由israeli-bank-scrapers提供支持。Asher帮助您在多个来源之间聚合和分析您的金融交易，同时确保您的数据隐私和安全。 信息被刮取并存储在一个本地加密的SQLite数据库中。

功能

• MCP服务器：实现模型上下文协议，便于与MCP主机（如Claude）集成
• 广泛的集成：支持israeli-bank-scrapers提供的所有以色列银行和信用卡公司。
• 本地优先：您的金融数据永远不会离开您的机器
• 加密：敏感数据在静止状态下进行加密
• CLI：通过命令行轻松设置和管理
• 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执行）（用于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桌面集成（可以直接使用npm run configure:claude启动）

使用

MCP工具

Asher提供了几个供MCP主机使用的工具：

• 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. 第三方服务：本软件可能集成第三方服务。开发者不对这些第三方的行为、内容或政策负责。

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