MCP Brex Server

🚀 Brex MCP 服务器

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