AI导哈

财务数据集成服务

BudgetBakers MCP Server是一个用于集成Claude与BudgetBakers Wallet API的服务，提供财务数据访问功能，包括账户、交易、类别和消费分析。

  • by vmrchnk
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 vmrchnk/budgetbakers-mcp

使用说明

BudgetBakers MCP服务器

MCP服务器，用于将Claude与 BudgetBakers钱包 API允许克劳德访问财务数据：账户、交易、类别和支出分析。

快速开始

增添 ~/.claude/settings.json （或克劳德桌面配置）：

{
  "mcpServers": {
    "budgetbakers": {
      "command": "npx",
      "args": ["-y", "budgetbakers-mcp"],
      "env": {
        "BUDGETBAKERS_API_TOKEN": "<your-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": "<your-token>"
      }
    }
  }
}

技术细节

  • TypeScript、ES2022、Node16模块
  • 依赖关系： @modelcontextprotocol/sdk, zod
  • 支持 agentHints=true -API返回有关分页、速率限制等的提示。
  • 通过提示提供的URL自动分页
  • 分析工具在服务器端聚合数据（API没有分析端点）

相关 MCP