BudgetBakers MCP服务器
](https://www.npmjs.com/package/budgetbakers-mcp)
MCP服务器，用于将Claude与 BudgetBakers钱包 API允许克劳德访问财务数据：账户、交易、类别和支出分析。
快速开始
增添 ~/.claude/settings.json （或克劳德桌面配置）：
{
"mcpServers": {
"budgetbakers": {
"command": "npx",
"args": ["-y", "budgetbakers-mcp"],
"env": {
"BUDGETBAKERS_API_TOKEN": ""
}
}
}
}您可以从BudgetBakers钱包设置中获取API令牌。
工具
| 工具 | 说明 |
|---|---|
get_accounts | 列出所有有余额的账户。过滤器： currency, accountType |
get_categories | 收入/支出类别。筛选器： name |
get_labels | 用户定义标签。筛选器： name |
search_transactions | 搜索交易记录。需要 accountId筛选条件：日期、类别、收款人、金额 |
get_transaction | 单个交易的完整细节 id |
spending_by_category | 按日期范围的类别分组的支出 |
cashflow_summary | 日期范围内的收入、支出和净现金流 |
top_merchants | 按日期范围消费的顶级商家 |
accountId是交易和分析工具所必需的。呼叫get_accounts首先得到它。
示例提示
- “显示我的账户和余额”
- “我二月份花了多少钱？”
- “我花最多的钱在什么上？”
- “本月排名前五的商家”
- “查找星巴克1月份的所有交易”
发展
git clone https://github.com/vmrchnk/budgetbakers-mcp.git
cd budgetbakers-mcp
npm install
npm run build要使用本地build而不是npm包：
{
"mcpServers": {
"budgetbakers": {
"command": "node",
"args": ["/path/to/budgetbakers-mcp/build/index.js"],
"env": {
"BUDGETBAKERS_API_TOKEN": ""
}
}
}
}技术细节
- TypeScript、ES2022、Node16模块
- 依赖关系：
@modelcontextprotocol/sdk,zod - 支持
agentHints=true-API返回有关分页、速率限制等的提示。 - 通过提示提供的URL自动分页
- 分析工具在服务器端聚合数据（API没有分析端点）