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