Lumenx MCP

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

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

このサーバーはModel Context Protocol (MCP) をベースに構築されており、e-billingプラットフォーム、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サポートにより、信頼性の高いコンテナ化されたデプロイが可能です。

💻 使用例

基本的な使用法

サーバーを起動するための基本的なコマンドは以下の通りです。

python -m legal_spend_mcp.server

高度な使用法

データソースを有効にし、資格情報を設定するための高度な設定例です。

# 使用するデータソースを有効にする
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

📚 ドキュメント

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

サーバーは、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-Billingと案件管理

• 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ファイル。

📄 ライセンス

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