Lumenx MCP

🚀 LumenX-MCP: 法務費用インテリジェンスサーバー

法務費用データの潜在能力を最大限に引き出しましょう。 LumenX-MCPはオープンソースのエンタープライズグレードのサーバーで、あらゆるソースからの法務および財務データを統合し、AIエージェントと分析プラットフォームに対して単一のインテリジェントなアクセスポイントを提供します。

モデルコンテキストプロトコル (MCP) をベースに構築されたこのサーバーは、eビリングプラットフォーム、ERPシステム、データベース、さらにはローカルファイルにシームレスに接続でき、断片的なデータをクエリ可能で実行可能なリソースに変換します。

🚀 クイックスタート

前提条件

• Python 3.10 以上
• Docker（最も簡単なセットアップに推奨）
• サポートされているデータソースの1つ以上へのアクセス

インストール

Dockerを使用する場合（推奨）

一貫性のある分離された環境を構築するために、Dockerの使用を推奨します。

1. Dockerイメージをビルドする：

docker build -t legal-spend-mcp .

2. コンテナを起動する：

docker run -d --name legal-spend-mcp -v ./.env:/app/.env -v ./data:/app/data legal-spend-mcp

ソースからインストールする場合

ソースからインストールする場合は、2つのオプションがあります。

1. 編集可能なインストール（開発者向けに推奨）： これはpyproject.tomlファイルを使用し、貢献する予定がある場合の最適なオプションです。

# リポジトリをクローンする
git clone https://github.com/DatSciX-CEO/LumenX-MCP.git
cd LumenX-MCP

# 仮想環境を作成する
python -m venv venv
source venv/bin/activate  # Windowsの場合は: venv\Scripts\activate

# 開発用依存関係を含めて編集可能モードでインストールする
pip install -e .[dev]

2. requirements.txtを使用する： これは、デプロイまたは一般的な使用のための依存関係をインストールする標準的な方法です。

# クローンして仮想環境を有効にした後
pip install -r requirements.txt

設定

1. 環境ファイルを作成する：

cp .env.template .env

2. データソースを有効にする： .envファイルを編集して、使用するプラットフォームを有効にし、資格情報を提供します。サーバーは有効にしたソースのみを初期化します。

# 使用するデータソースを有効にする
LEGALTRACKER_ENABLED=true
LEGALTRACKER_API_KEY=your_api_key_here
LEGALTRACKER_BASE_URL=https://api.legaltracker.com

# インスタンス固有のURLの場合は、組織のエンドポイントを使用してください
ONIT_ENABLED=true
ONIT_API_KEY=your_api_key
ONIT_BASE_URL=https://<your-company>.onit.com

サーバーを起動する

設定が完了したら、以下のコマンドでサーバーを起動できます。

python -m legal_spend_mcp.server

より詳細な手順については、QUICKSTART.mdガイドを参照してください。

✨ 主な機能

• 統合データアクセス：LegalTrackerやSAPからローカルのCSVファイルまで、複数のデータソースに同時に接続できます。
• 包括的な分析：支出の要約、ベンダーのパフォーマンス分析、予算と実績の差異などのツールで即座に洞察を得ることができます。
• 拡張性に優れた設計：モジュール式のアーキテクチャにより、新しいデータソースコネクタを簡単に追加し、機能を拡張できます。
• AI対応：法務テックの未来に備えて構築されており、AIエージェントや大規模言語モデルとの強力な統合を可能にします。
• 高性能：完全に非同期のアーキテクチャにより、データの取得が高速かつ効率的です。
• エンタープライズグレード：堅牢で検証可能な構成と完全なDockerサポートにより、信頼性の高いコンテナ化されたデプロイが可能です。

📚 ドキュメント

利用可能なツールとリソース

このサーバーは、MCP互換のクライアントに対して豊富なツールとリソースを提供します。

ツール（呼び出し可能な関数）

• get_legal_spend_summary：強力なフィルタリング機能を備えた集計された支出データを取得します。
• get_vendor_performance：特定のベンダーのパフォーマンス指標を分析します。
• get_budget_vs_actual：予算額と実際の支出を比較します。
• search_legal_transactions：特定の取引に対する全文検索を実行します。

リソース（データオブジェクト）

• legal_vendors：すべてのデータソースにまたがるすべてのベンダーの包括的なリストです。
• data_sources：接続されているすべてのデータソースのステータスと構成です。
• spend_categories：利用可能なすべての支出カテゴリ、業務分野、および部署です。
• spend_overview/recent：過去30日間の支出活動の概要です。

サポートされているデータソース

LumenX-MCPは、すべての法務データの中央ハブとして構築されています。

Eビリングと案件管理

• LegalTracker：リアルタイムの請求書と案件データ。
• SimpleLegal：（予定）SimpleLegalのAPIとの統合。
• Brightflag：（予定）BrightflagのAPIとの統合。
• TyMetrix 360：（予定）TyMetrix 360のAPIとの統合。
• Onit：（予定）OnitのAPIとの統合。

ERPシステム

• SAP：SQL Serverデータベース接続を介して。
• Oracle：Oracleデータベース接続を介して。
• Microsoft Dynamics 365：（予定）Dynamics 365のAPIとの統合。
• NetSuite：（予定）NetSuiteのAPIとの統合。

データベース

• PostgreSQL：法務支出テーブルを完全にサポートします。
• SQL Server：SAPや他のERPシステムと互換性があります。
• Oracle：エンタープライズ財務システムとの統合。

ファイルインポート

• CSV：標準のカンマ区切り値。
• Excel：シート名を設定可能な.xlsxファイル。

🤝 貢献のお願い

バグ修正から新しいデータソースコネクタまで、あらゆる種類の貢献を歓迎します！ 詳細については、CONTRIBUTING.mdガイドを参照してください。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については、LICENSEファイルを参照してください。