项目简介

Brex Financial数据MCP服务器是一个基于Model Context Protocol (MCP) 构建的应用后端,它充当AI Agent与Brex金融平台之间的桥梁。通过此服务器,AI Agent可以安全高效地访问Brex平台上的财务数据,并利用预设工具执行特定操作,从而实现与Brex金融服务的智能化交互。

主要功能点

  • 资源 (Resources)

    • 账户资源:获取账户列表和账户详情。
    • 费用资源:检索费用列表和费用详情,包括卡费用和普通费用,支持分页和信息扩展(如商户和预算信息)。
    • 预算资源:访问预算、消费限额和预算项目等信息。
    • 团队资源:获取当前用户信息。
  • 工具 (Tools)

    • 收据管理
      • 'match_receipt':创建收据匹配链接,用于上传收据并自动关联费用。
      • 'upload_receipt':上传收据图片数据。
    • 费用管理
      • 'update_expense':更新卡费用的详细信息(如备注、类别等)。
      • 'get_all_expenses':获取所有费用,支持过滤选项和扩展信息。
      • 'get_all_card_expenses':获取所有卡费用,支持过滤选项和扩展信息。

安装步骤

  1. 克隆仓库

    git clone https://github.com/crazyrabbitLTC/mcp-brex-server.git
    cd mcp-brex-server
  2. 安装依赖

    npm install
  3. 配置环境变量 创建 '.env' 文件,并填入您的 Brex API 密钥和相关配置:

    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

    请将 'your_brex_api_key_here' 替换为您的实际 Brex API 密钥。

  4. 构建服务器

    npm run build

服务器配置 (Claude等MCP客户端)

要将此MCP服务器配置到 Claude Desktop 等MCP客户端,您需要编辑客户端的配置文件。以 Claude Desktop 为例,配置文件通常位于:

  • macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
  • Windows: '%APPDATA%\Claude\claude_desktop_config.json'

在 'claude_desktop_config.json' 文件中,找到 'mcpServers' 部分并添加以下配置:

{
  "mcpServers": {
    "brex-server": {  // 服务器名称,可自定义
      "command": "node", // 启动命令
      "args": [ // 命令参数
        "/path/to/mcp-brex-server/build/index.js" //  指向编译后的服务器入口文件,请替换为实际路径
      ],
      "env": { // 环境变量
        "BREX_API_KEY": "your_brex_api_key_here", // 您的 Brex API 密钥,请替换为实际密钥
        "BREX_API_URL": "https://platform.brexapis.com", // Brex API URL,默认值
        "PORT": "3000", // 服务器端口,默认值
        "NODE_ENV": "development", // 运行环境,默认值
        "RATE_LIMIT_REQUESTS": "1000", // 请求速率限制,默认值
        "RATE_LIMIT_WINDOW_MS": "60000", // 速率限制窗口大小,默认值
        "LOG_LEVEL": "info" // 日志级别,默认值
      }
    }
  }
}

请务必将 '/path/to/mcp-brex-server' 替换为您服务器的实际安装路径,并将 'your_brex_api_key_here' 替换为您的 Brex API 密钥。保存配置文件并重启 Claude Desktop。

基本使用方法

配置完成后,MCP客户端(如 Claude Desktop)应该能够自动检测并连接到 Brex MCP 服务器。您可以通过客户端界面调用服务器提供的资源和工具,例如查询账户信息、获取费用数据或上传收据等,从而实现与 Brex 财务数据的交互。

在 Claude Desktop 中,如果服务器配置成功,您通常可以在输入框的右下角看到一个锤子图标,表示 MCP 服务器已连接。

信息

分类

商业系统