Brex

🚀 Brex MCP 服務器

Brex MCP 服務器是一個用於與 Brex API 集成的模型上下文協議（MCP）服務器，它能讓 AI 代理與財務數據和資源進行交互，為財務數據的訪問和管理提供了便捷的解決方案。

🚀 快速開始

Brex MCP 服務器作為 AI 代理與 Brex 金融平臺之間的橋樑，使 AI 代理能夠執行以下操作：

• 獲取賬戶信息和交易
• 訪問費用數據和收據
• 管理預算資源和支出限額
• 查看團隊信息

該服務器實現了符合 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 密鑰

配置

環境變量

設置以下環境變量：

export BEXP_API_KEY="your_api_key_here"

與 Claude 集成

在config.toml文件中添加以下內容以配置 MCP 服務器：

[server]
  name = "Brex MCP Server"
  description = "A server for interacting with Brex financial data."
  port = 5005

[blob_store]
  type = "local"
  path = "/var/lib/brexicmp/server/blobs"

[api_key]
  key = "your_api_key_here"

💻 使用示例

基礎用法

在開發過程中，你可以使用以下命令：

自動重載開發

npm run dev

格式檢查

npm run lint

測試

npm run test

📚 詳細文檔

調試

由於 MCP 服務器通過標準輸入輸出進行通信，調試可能具有挑戰性。我們推薦使用MCP Inspector進行調試。

安全注意事項

此服務器實施了多項安全措施：

• 對敏感財務資源執行只讀操作
• 不在代碼中存儲 API 憑據
• 實施速率限制以控制 API 請求
• 正確處理錯誤並記錄日誌

實施狀態

有關詳細的功能實現計劃和狀態，請參閱documentation/implementation_plan.md。

📄 許可證

此項目根據 MIT 許可證授權 - 請查看LICENSE文件獲取詳細信息。

👨‍💻 作者

Dennison Bertram - dennison@dennisonbertram.com