Lumenx MCP

🚀 LumenX-MCP：法律支出智能服務器

釋放您法律支出數據的全部潛力。 LumenX-MCP 是一個開源的企業級服務器，它可以統一來自任何來源的法律和財務數據，為人工智能代理和分析平臺提供單一的智能訪問點。

該服務器基於**模型上下文協議（MCP）**構建，允許您無縫連接到電子賬單平臺、企業資源規劃（ERP）系統、數據庫，甚至本地文件，將碎片化的數據轉化為可查詢、可操作的資源。

🚀 快速開始

前提條件

• Python 3.10 或更高版本
• Docker（推薦用於最簡單的設置）
• 訪問一個或多個受支持的數據源

📦 安裝指南

使用 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

從源代碼安裝

如果您更喜歡從源代碼安裝，有兩種選擇：

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 文件。
• 全面分析：使用支出彙總、供應商績效分析和預算差異等工具立即獲取洞察。
• 設計可擴展：模塊化架構使添加新的數據源連接器和擴展功能變得容易。
• 支持人工智能：為法律科技的未來而構建，支持與人工智能代理和大語言模型進行強大的集成。
• 高性能：完全異步的架構確保數據檢索快速高效。
• 企業級：強大、可驗證的配置和完整的 Docker 支持，實現可靠的容器化部署。

💻 使用示例

基礎用法

以下是啟動服務器的基本命令：

python -m legal_spend_mcp.server

高級用法

在配置文件中啟用多個數據源並啟動服務器以獲取更全面的數據：

# 啟用多個數據源
LEGALTRACKER_ENABLED=true
LEGALTRACKER_API_KEY=your_api_key_here
LEGALTRACKER_BASE_URL=https://api.legaltracker.com

ONIT_ENABLED=true
ONIT_API_KEY=your_api_key
ONIT_BASE_URL=https://<your-company>.onit.com

python -m legal_spend_mcp.server

📚 詳細文檔

可用工具和資源

服務器為任何與 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 旨在成為您所有法律數據的中心樞紐。

電子賬單和事項管理

• 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 文件。