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 访问令牌

设置

克隆此存储库：

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

安装依赖项：

npm install

使用您的 Brex API 令牌创建一个.env文件：

BREX_API_KEY=your_token_here
BREX_API_URL=https://platform.brexapis.com
PORT=3000
NODE_ENV=development
RATE_LIMIT_REQUESTS=1000
RATE_LIMIT_WINDOW_MS=60000
LOG_LEVEL=info

构建服务器：

npm run build

使用 Claude 进行配置

要与 Claude Desktop 一起使用，您需要将服务器添加到 Claude 的配置文件中：

在 macOS 上： ~/Library/Application Support/Claude/claude_desktop_config.json在 Windows 上： %APPDATA%\Claude\claude_desktop_config.json

打开 Claude 桌面版，点击 Claude 菜单并选择“设置...”进入设置。
点击左侧边栏的“开发者”，然后点击“编辑配置”
使用 Brex MCP 服务器设置更新配置文件：

{
  "mcpServers": {
    "brex-server": {
      "command": "node",
      "args": [
        "/path/to/brex-mcp-server/build/index.js"
      ],
      "env": {
        "BREX_API_KEY": "your_brex_api_key_here",
        "BREX_API_URL": "https://platform.brexapis.com",
        "PORT": "3000",
        "NODE_ENV": "development",
        "RATE_LIMIT_REQUESTS": "1000",
        "RATE_LIMIT_WINDOW_MS": "60000",
        "LOG_LEVEL": "info"
      }
    }
  }
}

请确保：

将/path/to/brex-mcp-server替换为您安装服务器的实际路径
将your_brex_api_key_here替换为你的实际 Brex API 密钥
使用绝对路径作为服务器位置

只需要BREX_API_KEY和BREX_API_URL值；其他环境变量具有合理的默认值，但可以根据需要进行自定义。

保存文件并重新启动 Claude for Desktop
通过检查输入框右下角的锤子图标来验证服务器是否正常工作

发展

对于使用自动重建的开发：

npm run dev

检查你的代码：

npm run lint

运行测试：

npm run test

调试

由于 MCP 服务器通过 stdio 进行通信，调试起来可能比较困难。我们建议使用MCP Inspector进行调试。

安全注意事项

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

敏感财务资源的只读操作
代码中不存储 API 凭证
API 请求的速率限制
正确的错误处理和日志记录

实施情况

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

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。

作者

丹尼森·伯特伦 - dennison@dennisonbertram.com

Brex MCP Server

Integrations