Asher-个人财务数据MCP服务器
更接近你自己的数据，类固醇！
以色列银行和信用卡公司的安全、本地首个金融数据聚合器，使用TypeScript构建，由 以色列银行劫匪.Asher可帮助您汇总和分析多个来源的财务交易，同时保护您的数据隐私和安全。 信息被抓取并存储在本地加密的SQLite数据库中。
特性
- MCP服务器：实现模型上下文协议，便于与MCP主机（如Claude）集成
- 广泛集成：支持以色列所有银行和信用卡公司 以色列银行劫匪.
- 本地优先：您的财务数据永远不会离开您的机器
- 加密：敏感数据在静止时加密
- 命令行界面：通过命令行轻松设置和管理
- TypeScript：考虑到型号安全
先决条件
- Node.js 18+
- npm
安装
- 克隆存储库：
git clone https://github.com/shlomiuziel/asher-mcp.git
cd asher-mcp- 安装依赖项：
npm install- 构建项目：
npm run build- 可选的：在系统范围内安装
ashercli命令：
npm install -g .- 全局安装tsx（TypeScript Execute）（克劳德桌面集成所需）：
npm install -g tsx数据库位置
数据库文件存储在以下位置，具体取决于您的操作系统：
- macOS：
~/Library/Application Support/Asher/database.db - Linux：
~/.local/share/Asher/database.db - 窗户：
%APPDATA%/Asher/database.db
首次运行和配置
- 准备一份
credentials.json使用您的提供商凭据创建文件。
查看支持的提供商和凭据字段 这里.
- 获取您的凭证：
asher ingest-creds -f credentials.json- 使用此命令根据需要更新凭据。删除可以手动完成（请参阅 scraper_credentials 桌子）。 - 系统将提示您输入数据库的加密密钥（对于首次设置，您将重新输入以确认）。
- 在安装过程中，系统将提示您：
- 启用通知（测试通知将有助于权限） - 可选地执行第一次抓取（建议避免由于大量数据而导致的延迟和可能的超时） - 配置Claude Desktop集成（可以直接启动 npm run configure:claude)
用法
MCP工具
Asher为MCP主机提供了几个工具：
fetchTransactions：获取最近的交易并将其存储在数据库中。describeTable：获取表的详细信息（列、索引）。listTables：列出数据库中的所有表。getTableSchema：获取特定表的架构。sqlQuery：对允许的表执行安全的SELECT查询（防止SQL注入和未经授权的访问）。fetch-last-month-transactions：提取并汇总上个月的交易和费用。
其中包含一个示例提示，可帮助您生成详细的月度报告。
测试您的MCP服务器
您可以运行MCP检查器进行本地测试：
npm run start:mcp:inspector安全
- 所有敏感数据都是静态加密的。
- 银行凭据使用您的加密密钥安全地存储在数据库中。
- 应用程序遵循最小特权原则(
chmod 600在数据库文件上）。 - 加密密钥是在运行时请求的，从不存储在磁盘上。
测试
运行所有测试：
npm test许可证
该项目根据MIT许可证获得许可。请参阅 许可证 文件以获取详细信息。
⚠️ 重要免责声明
在使用本软件之前，请仔细阅读本免责声明。
该软件旨在帮助您分析财务数据，并使MCP主机可以访问这些数据。但是，使用本软件即表示您承认并同意以下内容：
- 不担保：本软件按“原样”提供，不提供任何形式的明示或暗示保证，包括但不限于适销性、特定用途适用性和不侵权保证。
- 金融数据安全:
- 您全权负责您的银行凭证和财务数据的安全 - 切勿与任何人共享您的凭据或加密密钥 - 开发人员不对未经授权访问您的财务账户负责
- 使用风险自负:
- 开发人员不对因使用本软件而导致的任何经济损失、数据丢失或其他损害负责 - 始终通过官方银行渠道核实重要财务信息 - 该软件可能与所有银行机构不兼容
- 无责任：在任何情况下，作者或版权持有人均不对因软件或软件的使用或其他交易而产生、产生或与之相关的任何索赔、损害赔偿或其他责任承担责任，无论是在合同、侵权或其他诉讼中。
- 第三方服务：此软件可能与第三方服务集成。开发人员不对这些第三方的行为、内容或政策负责。
使用本软件即表示您已阅读本免责声明并同意受其条款的约束。