🚀 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