JinDaGe - Brex MCP Details

article

README

🚀 Brex MCP 服务器

Brex MCP 服务器是一个用于与 Brex API 集成的模型上下文协议（MCP）服务器，它能让 AI 代理与财务数据和资源进行交互，为财务数据的访问和管理提供了便捷的解决方案。

🚀 快速开始

Brex MCP 服务器作为 AI 代理与 Brex 金融平台之间的桥梁，使 AI 代理能够执行以下操作：

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

该服务器实现了符合 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

Brex