Brex MCP 服务器

Brex MCP 服务器

一个用于Brex API的模型上下文协议（MCP）服务器。该服务器针对安全、小型、只读的响应进行了优化，支持投影和批处理。

新功能（0.3.2）

• 修复：工具现在包含一个宽松的（或允许性的）选项 inputSchema 在工具列表中，这样客户如Claude Code就能正确显示并允许调用工具。处理程序的行为没有变化。

安装

克劳德·科德

# Install the package
npm install -g mcp-brex

# Add to Claude Code with your API key
claude mcp add brex --env BREX_API_KEY=your_brex_api_key -- npx mcp-brex

Claude Desktop（可译为“Claude桌面版”或根据具体语境简化为“Claude桌面”）

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "brex": {
      "command": "npx",
      "args": ["mcp-brex"],
      "env": {
        "BREX_API_KEY": "your_brex_api_key"
      }
    }
  }
}

手动设置（开发）

git clone https://github.com/dennisonbertram/mcp-brex.git
cd mcp-brex
npm install
npm run build
claude mcp add brex --env BREX_API_KEY=your_key -- node build/index.js

资源

• brex://expenses | brex://expenses/{id} | brex://expenses/card | brex://expenses/card/{id}
• brex://budgets | brex://budgets/{id}
• brex://spend_limits | brex://spend_limits/{id}
• brex://budget_programs | brex://budget_programs/{id}
• brex://transactions/card/primary | brex://transactions/cash/{id}
• brex://docs/usage （代理商简明使用指南）

注：

• 资源接受 ?summary_only=true&fields=id,status,... 以控制有效载荷大小。
• 费用资源自动扩展 merchant 并且 budget 为了提高可读性。

工具（除非另有说明，否则为只读）

• 预算： get_budgets， get_budget
• 消费限额： get_spend_limits， get_spend_limit
• 预算项目： get_budget_programs， get_budget_program
• 费用（单页）： get_expenses
• 费用（分页显示）： get_all_expenses， get_all_card_expenses
• 按ID支出： get_expense， get_card_expense
• 信用卡对账单： get_card_statements_primary
• 交易： get_card_transactions， get_cash_transactions （注：交易中无日期筛选/展开功能）
• 现金流量表： get_cash_account_statements
• 账户： get_all_accounts， get_account_details
• 收据（手写）： match_receipt， upload_receipt
• 更新（撰写）： update_expense

如何调用工具

总是发送以下参数 arguments (not input）。 通过分页和过滤来保持有效载荷较小。

常见参数：

• 分页： page_size （小于等于50） max_items （建议不超过200字）
• 日期筛选： start_date， end_date， window_days
• 状态过滤： status 费用/交易数组
• 金额过滤： min_amount， max_amount 用于开支
• 商户过滤： merchant_name 用于支出
• 扩展控制： expand 数组包含嵌套对象（例如。， ["merchant", "budget"]）

推荐示例：

{
  "name": "get_all_card_expenses",
  "arguments": {
    "page_size": 10,
    "max_items": 20,
    "start_date": "2025-08-25T00:00:00Z",
    "end_date": "2025-08-26T00:00:00Z",
    "status": ["APPROVED"],
    "min_amount": 100
  }
}

{
  "name": "get_expenses",
  "arguments": {
    "limit": 5,
    "status": "APPROVED"
  }
}

{
  "name": "get_card_transactions",
  "arguments": {
    "limit": 10,
    "summary_only": true,
    "fields": ["id", "posted_at", "amount.amount", "amount.currency", "merchant.raw_descriptor"]
  }
}

{
  "name": "get_all_accounts",
  "arguments": {
    "page_size": 10,
    "max_items": 20,
    "status": "ACTIVE"
  }
}

{
  "name": "get_transactions",
  "arguments": {
    "accountId": "acc_123456789",
    "limit": 10
  }
}

{
  "name": "get_expenses",
  "arguments": {
    "limit": 5,
    "expand": ["merchant", "user"]
  }
}

分页和过滤的最佳实践

重要使用分页、过滤和排序来控制响应大小，而不是依赖于摘要。

数据控制的关键参数：

• page_size: number — 每页项目数（建议：≤50）
• max_items: number — 所有页面的最大总项目数（建议：≤200）
• start_date/end_date: string — ISO日期范围过滤
• window_days: number — 将大的日期范围拆分成更小的批次
• status: string[] — 按状态筛选（例如，["已批准", "待处理"]）
• min_amount/max_amount: number — 基于金额的费用过滤

最佳实践：

• 始终使用日期范围 对于批量请求，以避免过大的响应
• 使用较小的页面尺寸 (≤50) 且合理的最大项目数 (≤200)
• 应用状态过滤器 只获取您需要的数据
• 使用 window_days （例如，7）以批量处理大日期范围
• 控制嵌套对象展开 （与）……一起，带着 expand 参数：
  • 默认： expand: [] 返回简洁的对象（每个对象约500-1000个标记）
  • 随着扩张： expand: ["merchant", "budget"] 返回完整对象（每个约15K+个标记）
  • 可用的扩展选项： merchant， budget， user， department， location， receipts
• 先用小范围进行测试 在扩大规模之前
• 现金终端需要额外的Brex权限范围；优雅地处理403错误

注：Brex交易端点（卡和现金）不支持 posted_at_start 或者 expand检索交易，并在需要时在客户端进行过滤 posted_at/posted_at_date。

金钱与单位

Brex上的所有金额均以分为单位。此服务器默认在工具输出中标注货币字段，以防止单位错误：

• amount_cents: 整数（例如，100000）
• 金额（美元）：以美元为单位的数字（例如，1000.0）
• amount_formatted：用户友好的字符串（例如，“$1,000.00”）

示例（费用 购买金额）：

{
  "purchased_amount": {
    "amount_cents": 100000,
    "amount_dollars": 1000.0,
    "amount_formatted": "$1,000.00",
    "currency": "USD"
  }
}

控制键：

• format_amounts： "cents" | "dollars" | "both" （默认： "both"）
• include_formatted布尔值（默认：true）
• include_summary布尔值（默认：true）添加 meta.summary 总计/平均值

出版

仅 build/， README.md，和 LICENSE 已发布。

许可证

MIT —— 参见 LICENSE.