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
通过历史快照获取一段时间内的汇总净值。
例子： “我的净资产是多少？”
______________________________________________________________________
发展
先决条件
设置
- 克隆存储库：
git clone https://github.com/rameezk/finwise-mcp.git
cd finwise-mcp- 设置环境：
cp .env.example .env
# Edit .env and add your FINWISE_API_KEY- 进入开发shell：
direnv allow # if using direnv
# or
nix develop- 安装依赖项：
uv syncMCP检验员测试
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"
}
}
}
}许可证
麻省理工学院