MCP Brex Server

🚀 Brex MCP 服務器

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://teams - 列出所有團隊
• brex://teams/{id} - 獲取特定團隊的詳細信息

工具

收據管理

• 上傳和管理與支出相關的收據

支出管理

• 創建、讀取、更新和刪除支出記錄

📦 安裝指南

先決條件

• Node.js (建議使用版本 14 或更高)
• npm (建議使用版本 6 或更高)

設置步驟

1. 克隆倉庫：

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

2. 安裝依賴項：

   npm install
   

3. 配置環境變量：

   • 創建一個.env文件，並添加以下內容：

     PORT=3000
     API_KEY=your_api_key_here
     DATABASE_URL=your_database_url_here
     

4. 啟動開發服務器：

   npm run dev
   

5. 構建和部署：

   npm run build
   npm start
   

📚 詳細文檔

與 Claude 配置集成

要將此服務器與 Claude 配置一起使用，請按照以下步驟操作：

1. 在 Claude 配置中添加 MCP 服務器的詳細信息。
2. 配置完成後，啟動 Claude 代理以開始與 Brex MCP 服務器交互。

開發指南

自動重建開發

npm run dev

代碼檢查

npm run lint

運行測試

npm run test

調試技巧

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

安全注意事項

此服務器實施了以下安全措施：

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

實現狀態

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

📄 許可證

此項目根據 MIT License 授權，具體內容請參閱LICENSE文件。

👨‍💻 作者

Dennison Bertram - dennison@dennisonbertram.com