MCP Brex Server

🚀 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