个人金融数据查询服务

Finwise MCP服务器

MCP（模型上下文协议）服务器，用于连接您的 Finwise 将个人财务数据发送给LLM，实现自然语言查询，如：

• “我的净资产是多少？”
• “上个月我在外卖上花了多少钱？”
• “显示我的所有信用卡交易”
• “我的杂货预算是多少？”

安装

克劳德桌面版

添加 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）：

{
  "mcpServers": {
    "finwise": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/rameezk/finwise-mcp", "finwise-mcp"],
      "env": {
        "FINWISE_API_KEY": "your-api-key"
      }
    }
  }
}

重新启动克劳德桌面（Cmd+Q，然后重新打开）。

克劳德代码

创建 .mcp.json 在您的项目目录中：

{
  "mcpServers": {
    "finwise": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/rameezk/finwise-mcp", "finwise-mcp"],
      "env": {
        "FINWISE_API_KEY": "your-api-key"
      }
    }
  }
}

重新启动Claude Code，并在提示时批准MCP服务器。

使用Nix

克劳德代码

claude mcp add finwise -- nix run github:rameezk/finwise-mcp

手动配置

添加到MCP配置中：

{
  "mcpServers": {
    "finwise": {
      "command": "nix",
      "args": ["run", "github:rameezk/finwise-mcp"],
      "env": {
        "FINWISE_API_KEY": "your-api-key"
      }
    }
  }
}

获取API密钥

从中的“设置”>“API密钥”获取Finwise API密钥 Finwise仪表板.

可用工具

list_accounts

列出所有财务账户，包括名称、类型、货币和余额。

例子： “我有什么账户？”

list_categories

列出所有带有ID和名称的交易类别。

例子： “我有哪些类别？”

list_transactions

列出具有可选过滤器和分页的交易。

过滤器：

• from_date / to_date -日期范围（YYYY-MM-DD）
• transaction_types -按类型筛选： ["debit", "credit"]
• category_ids -按类别筛选
• page_number / page_size -分页

示例：

• “显示我上个月的交易记录”
• “我在外卖上花了多少钱？”
• “列出我的所有信用卡借记”

get_category_budgets

获取按类别和交易类型分组的预算总额。

例子： “我的杂货预算是多少？”

get_net_worth

通过历史快照获取一段时间内的汇总净值。

例子： “我的净资产是多少？”

发展

先决条件

• 尼克斯 启用薄片
• direnv （可选，用于自动环境加载）

设置

1. 克隆存储库：

   复制

   git clone https://github.com/rameezk/finwise-mcp.git
   cd finwise-mcp
   

2. 设置环境：

   复制

   cp .env.example .env
   # Edit .env and add your FINWISE_API_KEY
   

3. 进入开发shell：

   复制

   direnv allow  # if using direnv
   # or
   nix develop
   

4. 安装依赖项：

   复制

   uv sync
   

MCP检验员测试

uv run mcp dev src/finwise_mcp/server.py

这将打开一个web UI，您可以在其中交互式地测试单个工具。

为克劳德在当地跑步

如果在本地开发并想用Claude进行测试，请使用完整的nix路径：

{
  "mcpServers": {
    "finwise": {
      "command": "/path/to/.nix-profile/bin/nix",
      "args": ["develop", "/path/to/finwise-mcp", "--command", "uv", "run", "finwise-mcp"],
      "env": {
        "FINWISE_API_KEY": "your-api-key"
      }
    }
  }
}

许可证

麻省理工学院