Lumenx MCP

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

LumenX-MCP 是一款開源的企業級服務器，它能夠統一來自任何來源的法律和財務數據，為 AI 代理和分析平臺提供單一、智能的訪問點，充分挖掘您的法律支出數據潛力。

該服務器基於 模型上下文協議（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 文件。
• 全面分析：藉助支出彙總、供應商績效分析和預算差異等工具，立即獲取洞察。
• 設計可擴展：模塊化架構便於添加新的數據源連接器並擴展功能。
• 支持 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 旨在成為您所有法律數據的中心樞紐。

電子賬單和事項管理

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

🤝 貢獻

我們歡迎各種類型的貢獻，從修復 bug 到添加新的數據源連接器！有關如何開始的詳細信息，請參閱我們的 CONTRIBUTING.md 指南。

📄 許可證

本項目採用 MIT 許可證 - 詳情請參閱 LICENSE 文件。