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://teams - 列出所有团队
• brex://teams/{id} - 获取特定团队的详细信息

工具

收据管理

• 上传和管理与支出相关的收据

支出管理

• 创建、读取、更新和删除支出记录

安装指南

先决条件

• Node.js (建议使用版本14或更高)
• npm (建议使用版本6或更高)

设置步骤

1. 克隆仓库：

   git clone https://github.com/yourusername/brex-mcp-server.git
   cd brex-mcp-server
   

2. 安装依赖项：

   npm install
   

3. 配置环境变量：

   • 创建一个.env文件，并添加以下内容：

     PORT=3000
     API_KEY=your_api_key_here
     DATABASE_URL=your_database_url_here
     

4. 启动开发服务器：

   npm run dev
   

5. 构建和部署：

   npm run build
   npm start
   

与Claude配置集成

要将此服务器与Claude配置一起使用，请按照以下步骤操作：

1. 在Claude配置中添加MCP服务器的详细信息。
2. 配置完成后，启动Claude代理以开始与Brex MCP服务器交互。

开发指南

自动重建开发

npm run dev

代码检查

npm run lint

运行测试

npm run test

调试技巧

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

安全注意事项

此服务器实施了以下安全措施：

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

实现状态

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

许可证

此项目根据MIT License授权，具体内容请参阅LICENSE文件。

作者

Dennison Bertram - dennison@dennisonbertram.com