🚀 LumenX-MCP：法律支出智能服务器
释放您法律支出数据的全部潜力。 LumenX-MCP 是一个开源的企业级服务器，它可以统一来自任何来源的法律和财务数据，为人工智能代理和分析平台提供单一的智能访问点。
该服务器基于**模型上下文协议（MCP）**构建，允许您无缝连接到电子账单平台、企业资源规划（ERP）系统、数据库，甚至本地文件，将碎片化的数据转化为可查询、可操作的资源。
🚀 快速开始
前提条件
- Python 3.10 或更高版本
- Docker（推荐用于最简单的设置）
- 访问一个或多个受支持的数据源
📦 安装指南
使用 Docker（推荐）
为了获得一致且隔离的环境，我们建议使用 Docker。
- 构建 Docker 镜像：
docker build -t legal-spend-mcp .
- 运行容器：
docker run -d --name legal-spend-mcp -v ./.env:/app/.env -v ./data:/app/data legal-spend-mcp
从源代码安装
如果您更喜欢从源代码安装，有两种选择：
- 可编辑安装（推荐给开发者）：这使用
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]
- 使用
requirements.txt：这是部署或一般使用时安装依赖项的标准方法。
# 克隆并激活虚拟环境后
pip install -r requirements.txt
配置
- 创建环境文件：
cp .env.template .env
- 启用您的数据源：编辑
.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://.onit.com
启动服务器
配置完成后，您可以使用以下命令启动服务器：
python -m legal_spend_mcp.server
有关更详细的说明，请参阅 QUICKSTART.md 指南。
✨ 主要特性
- 统一的数据访问：可同时连接多个数据源，从 LegalTracker 和 SAP 到本地 CSV 文件。
- 全面的分析：借助支出摘要、供应商绩效分析和预算差异等工具，即时获取洞察。
- 设计可扩展：模块化架构使添加新的数据源连接器和扩展功能变得容易。
- 支持人工智能：为法律科技的未来而构建，支持与人工智能代理和大语言模型进行强大的集成。
- 高性能：全异步架构确保数据检索快速高效。
- 企业级：拥有强大、可验证的配置，并完全支持 Docker，以实现可靠的容器化部署。
💻 使用示例
基础用法
以下是调用 get_legal_spend_summary 工具获取聚合支出数据的示例：
# 假设已经有了合适的客户端实例 client
summary = client.get_legal_spend_summary(filter_params)
print(summary)
高级用法
以下是结合多个工具进行复杂分析的示例，例如先获取供应商绩效，再进行预算对比：
# 假设已经有了合适的客户端实例 client
vendor_performance = client.get_vendor_performance(vendor_id)
budget_vs_actual = client.get_budget_vs_actual()
# 进行进一步的分析和处理
# ...
📚 详细文档
可用工具和资源
服务器为任何与 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 文件。