MCP 服务器

Brex MCP Server

一个模型上下文协议服务器，使人工智能代理能够与 Brex 金融平台数据交互，允许通过标准化的资源处理程序检索账户信息、费用、预算和团队数据。

README

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 for Desktop，然后通过单击 Claude 菜单并选择“Settings...”转到设置。
单击左侧边栏中的“Developer”，然后单击“Edit Config”
使用 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"
      }
    }
  }
}