Brex

🚀 Brex MCP サーバー

Brex APIと統合し、AIエージェントが財務データやリソースとやり取りできるようにするモデルコンテキストプロトコル（MCP）サーバーです。

🚀 クイックスタート

この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キー

環境変数

以下の環境変数を設定します。

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