Brex MCP 服务器

一个用于与Brex API集成的模型上下文协议（MCP）服务器，使AI代理能够与财务数据和资源交互。

概述

此MCP服务器充当AI代理与Brex金融平台之间的桥梁，允许代理：

• 获取账户信息和交易
• 访问费用数据和收据
• 管理预算资源和支出限额
• 查看团队信息

该服务器实现了符合MCP规范的标准资源处理器和工具，实现安全高效地访问财务数据。

功能

资源

账户资源

• brex://accounts - 列出所有账户
• brex://accounts/{id} - 访问特定账户详情

费用资源

• brex://expenses - 列出所有费用，带分页功能
• brex://expenses/{id} - 获取特定费用详情
• brex://expenses/card - 列出所有卡费用
• brex://expenses/card/{id} - 获取特定卡费用详情

注意：费用资源会自动扩展商家和预算信息，以显示可读的名称而不是ID。

预算资源

• brex://budgets - 列出所有预算，带分页功能
• brex://budgets/{id} - 获取特定预算详情
• brex://spend_limits - 列出所有支出限额
• brex://spend_limits/{id} - 获取特定支出限额详情
• brex://budget_programs - 列出所有预算方案
• brex://budget_programs/{id} - 获取特定预算方案详情

团队资源

• brex://users/me - 获取当前用户信息

工具

收据管理

• match_receipt - 将收据与现有费用匹配
• upload_receipt - 上传特定费用的收据

费用管理

• update_expense - 更新卡费用的详细信息（备注、类别等）
• get_all_expenses - 获取所有费用，带过滤选项和扩展后的商家/预算信息
• get_all_card_expenses - 获取所有卡费用，带过滤选项和扩展后的商家/预算信息

注意：出于安全考虑，创建、更新或删除预算、支出限额和预算方案的工具未在本版本中实现。

安装

先决条件

• Node.js v18或更高版本
• Brex API密钥

配置

环境变量

设置以下环境变量：

export BEXP_API_KEY="your_api_key_here"

与Claude集成

在config.toml文件中添加以下内容以配置MCP服务器：

[server]
  name = "Brex MCP Server"
  description = "A server for interacting with Brex financial data."
  port = 5005

[blob_store]
  type = "local"
  path = "/var/lib/brexicmp/server/blobs"

[api_key]
  key = "your_api_key_here"

开发

自动重载开发

npm run dev

格式检查

npm run lint

测试

npm run test

调试

由于MCP服务器通过标准输入输出进行通信，调试可能具有挑战性。我们推荐使用MCP Inspector进行调试。

安全注意事项

此服务器实施了多项安全措施：

• 对敏感财务资源执行只读操作
• 不在代码中存储API凭据
• 实施速率限制以控制API请求
• 正确处理错误并记录日志

实施状态

有关详细的功能实现计划和状态，请参阅documentation/implementation_plan.md。

许可证

此项目根据MIT许可证授权 - 请查看LICENSE文件获取详细信息。

作者

Dennison Bertram - dennison@dennisonbertram.com