项目简介
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':获取所有卡费用,支持过滤选项和扩展信息。
- 收据管理:
安装步骤
-
克隆仓库
git clone https://github.com/crazyrabbitLTC/mcp-brex-server.git cd mcp-brex-server -
安装依赖
npm install -
配置环境变量 创建 '.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 密钥。
-
构建服务器
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 服务器已连接。
信息
分类
商业系统